Aperçu seulement — activation requise

Téléchargements de construction avec QuickT

QuickT documente comment un client mobile communiquerait avec le service. Il ne peut pas soumettre de travail de production tant que le support n'a pas approuvé la conception et activé l'accès restreint.

QuicktRouteJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

Pour l'hôte API, QuickT vérifie les identifiants activés par le support avant un point de terminaison locataire assigné. Cette vue prête pour l'appareil clarifie également un chemin d'appel réservé au serveur.

URL du locatairehttps://quickt.io

AuthentificationX-API-Key: pending_activation_…

Profil du clientQuicktRoute

Version de l'APIv1

# Available only after support activation
export QUICKT_ROUTE_TOKEN="issued-after-review"

curl -X POST https://quickt.io/v1/resolve \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

QuickT organise la sécurité des identifiants autour du stockage secret côté serveur. Sa vue prête pour l'appareil ne compare aucune intégration de bundle client. Aucun journal public ni dépôt ne reste la vérification finale.

Résoudre un lien

Pour l'opération de résolution, QuickT vérifie la détection de la source avant les formats à partir d'une URL soumise.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`route_source`	URL HTTPS	Oui	Page média publique ou autorisée à analyser.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

QuickT organise l'identifiant de format autour de la valeur retournée inchangée. Sa vue prête pour l'appareil compare la disponibilité par lien. Aucune étiquette de qualité supposée ne reste la vérification finale.

Créer et suivre une tâche de téléchargement

Pour expliquer la création de Job, QuickT sépare la préparation asynchrone d'une requête HTTP courte. Une vue prête pour le périphérique donne à l'exécution de bounded worker sa propre place.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`route_source`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`route_format`	string	Oui	Un ID exact de la réponse de résolution.
`tenant`	string	Non	Domaine du locataire affecté. Généralement omis.

curl -X POST https://quickt.io/v1/jobs \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"route_source":"https://www.youtube.com/watch?v=VIDEO_ID","route_format":"18"}'

1202 AcceptéesEnregistrer route_job.

2État du sondageGET /v1/jobs/{route_job} avec la même clé.

3PrêtOuvrez l'URL de téléchargement signée.

État d ' avancement	Signification	Action du client
`queued`	Admis dans la file d'attente limitée.	Sondage à nouveau avec backoff.
`extracting`	Actualisation des métadonnées source ou de l'itinéraire.	Continuez à voter.
`processing`	Téléchargement, remixage ou fusion.	Afficher la progression du serveur.
`ready`	Téléchargement signé est disponible.	Envoyez l'URL à l'utilisateur.
`failed`	Erreur structurée terminale.	Lire `error_code`. Réessayez seulement quand conseillé.
`expired`	La sortie temporaire a été supprimée.	Créer un nouveau job.

curl https://quickt.io/v1/jobs/ROUTE_JOB \
  -H "X-API-Key: $QUICKT_ROUTE_TOKEN"

Une attente initiale d'une seconde est le point de départ pour le sondage de tâches sur QuickT.

Les erreurs prévisibles

Pour le contrat Error, QuickT commence par une enveloppe non 2xx. Sa vue prête pour l'appareil l'apparie avec un ID de demande de support et se termine par une gestion prévisible du client.

{
  "success": false,
  "error": {
    "code": "RATE_LIMITED",
    "category": "rate_limited",
    "message": "Too many requests. Please try again shortly.",
    "retryable": true,
    "details": {"retry_after_seconds": 20}
  },
  "request_id": "…"
}

HTTP	Signification typique	Action
400	URL, corps ou format non valide.	Corrigez la requête. Résolvez à nouveau pour les formats.
401	Clé manquante, invalide, expirée ou de mauvaise portée.	Vérifiez les informations d'identification côté serveur.
403	La politique du locataire ou de la source a rejeté la demande.	Ne contournez pas la politique. Contactez le support.
404	Offre d'emploi inconnue ou expirée.	Créez une nouvelle tâche si nécessaire.
429	Limite de demandes ou de tâches actives atteinte.	Honor `retry_after_seconds`.
503	File d'attente/capacité ou amont temporairement indisponible.	Réessayez avec un décalage et une gigue exponentiels.

Contrat d ' exploitation

QuickT choisit les limites mobile-client pendant l'approbation afin que les réseaux de créateurs et l'API restent réactifs.

Utilisez une logique d'application idempotente et ne démarrez jamais de tâches en double pour le même clic utilisateur.
Le cache résout brièvement les métadonnées, mais traite toujours les URL de téléchargement signées comme expirant.
Utiliser un décalage exponentiel limité avec gigue pour 429, 503 et erreurs retentables.
Traitez uniquement les médias publics ou les médias auxquels vous êtes autorisé à accéder. Les contrôles DRM et d'accès ne sont pas contournés.
Conservez les ID de requête et les ID de tâche dans des journaux opérationnels privés.

Pour l'accès au schéma, QuickT vérifie l'activation avant l'exploration avant l'authentification attribuée. Cette vue prête pour le périphérique rend également les formes de requête documentées claires.

ACCÈS RÉVISÉ PAR L'OPÉRATEUR

Activer par le biais du support

Décrivez l'expérience mobile, ses attentes de trafic et les réseaux de créateurs dont elle a besoin. QuickT utilise ces informations pour attribuer les permissions d'analyse et de mise en file d'attente avant de révéler le secret une fois.

Demande d'activation Les clés sont limitées à la portée du client, révocables et émises via le formulaire de contact.