Aperçu seulement — activation requise

Téléchargements de construction avec QuickDL

QuickDL permet aux développeurs d'inspecter le modèle de requête compact avant l'activation. Le support doit valider le produit avant qu'une clé privée et un quota deviennent utilisables.

QuickDlJobsJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

Dans QuickDL, les identifiants activés par support sont présentés en premier lors de l'explication de l'hôte API. Cet utilitaire compact est suivi d'un point de terminaison locataire assigné et se termine par un chemin d'appel réservé au serveur.

URL du locatairehttps://quickdl.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientQuickDlJobs

Version de l'APIv1

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

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

QuickDL Il suit sans intégration de paquet client et ne garde aucun journal public ou dépôt en vue. Il suit sans intégration de paquet client et ne garde aucun journal public ou dépôt en vue.

Résoudre un lien

Dans QuickDL, la détection de la source vient en premier lors de l'explication de l'opération Resolve. Cet utilitaire compact suit avec des formats à partir d'une URL soumise et se ferme sur aucune sortie inventée.

POST/v1/resolvePortée: résoudre

SUR LE TERRAIN	Type de	Requis	Description
`public_link`	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
}

QuickDL gère l'identifiant de format en identifiant d'abord la valeur retournée inchangée. Il suit avec la disponibilité par lien et ne garde aucune étiquette de qualité supposée en vue.

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

L'utilitaire compact de QuickDL examine la préparation asynchrone pour la création de tâches. Il affiche ensuite une courte requête HTTP et ne masque pas l'exécution liée des travailleurs.

POST/v1/jobsPortée: emplois

SUR LE TERRAIN	Type de	Requis	Description
`public_link`	URL HTTPS	Oui	La même source normalisée soumise à résoudre.
`download_option`	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://quickdl.app/v1/jobs \
  -H "X-API-Key: $QUICKDL_JOB_KEY" \
  -H "Content-Type: application/json" \
  -d '{"public_link":"https://www.youtube.com/watch?v=VIDEO_ID","download_option":"18"}'

1202 AcceptéesEnregistrer quick_job.

2État du sondageGET /v1/jobs/{quick_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://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL présente trois points pratiques pour le sondage d'emploi. Le premier est une attente initiale d'une seconde. L'utilitaire compact couvre ensuite un retour en arrière plafonné. Son dernier point est la livraison temporaire signée.

Les erreurs prévisibles

QuickDL aborde le contrat d'erreur via une enveloppe non 2xx, puis un ID de demande de support. L'utilitaire compact maintient une gestion client prévisible explicite.

{
  "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

QuickDL accorde un quota compact spécifique au client qui prend en charge l'intégration sans déstabiliser les services sources.

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.

Dans QuickDL, l'activation avant l'exploration est présentée en premier lors de l'explication de l'accès au Schéma. Cet utilitaire compact est suivi d'une authentification assignée et se termine par des formes de requête documentées.

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

Activer par le biais du support

Fournissez à QuickDL le nom de l'intégration, le volume mensuel attendu et les sources requises. Identifiez les opérations que le serveur effectuera afin que l'approbation produise une clé unique à portée limitée.

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