Aperçu seulement — activation requise

Construire des téléchargements avec DWTT

DWTT publie ce plan d'intégration pour la planification, pas pour une exécution anonyme. Le support doit approuver le flux de travail du clip avant de délivrer une clé limitée et son quota de trafic.

DwttToolkitJSON sur HTTPSTravaux asynchronesScoped credentials

Démarrage rapide

DWTT facilite l'analyse de l'hôte API. La page commence avec des identifiants activés par le support, passe à un point de terminaison locataire assigné, et indique clairement un chemin d'appel réservé au serveur.

URL du locatairehttps://dwtt.app

AuthentificationX-API-Key: pending_activation_…

Profil du clientDwttToolkit

Version de l'APIv1

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

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

DWTT aborde la sécurité des identifiants via le stockage secret côté serveur, sans intégration dans le bundle client. Le flux de travail rationalisé ne conserve aucun journal public ni dépôt explicite.

Résoudre un lien

DWTT facilite l'opération Resolve à scanner. La page commence par la détection de la source, passe aux formats d'une URL soumise, et indique clairement qu'aucune sortie inventée n'est produite.

POST/v1/resolvePortée: résoudre

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

DWTT aborde l'identificateur de format via la valeur retournée inchangée, puis la disponibilité par lien. Le flux de travail simplifié ne conserve aucune étiquette de qualité supposée explicite.

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

Dans DWTT, la préparation asynchrone est prioritaire lors de l'explication de la création de tâche. Ce flux de travail rationalisé est suivi d'une courte requête HTTP et se termine par une exécution limitée du travailleur.

POST/v1/jobsPortée: emplois

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

1202 AcceptéesEnregistrer task_ref.

2État du sondageGET /v1/jobs/{task_ref} 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://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Pour expliquer le sondage des tâches, DWTT sépare l'attente initiale d'une seconde du recul plafonné. Un flux de travail simplifié donne une place propre à la livraison temporaire signée.

Les erreurs prévisibles

Une enveloppe non 2xx est le point de départ pour le contrat d'erreur sur DWTT. Un flux de travail simplifié présente ensuite un ID de demande de support et explique la gestion client prévisible.

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

DWTT définit des quotas de trafic lors de l'activation afin que les intégrations de clips et les réseaux sources ne soient pas surchargés.

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.

DWTT facilite l'accès au schéma pour une lecture facile. La page commence par l'activation avant l'exploration, passe à l'authentification assignée, et indique clairement les formes de requête documentées.

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

Activer par le biais du support

Envoyez à DWTT l'intégration prévue, le volume probable de requêtes et les réseaux cibles. Mentionnez si le client a besoin de résolution, de création de tâche ou des deux afin qu'une clé ciblée puisse être approuvée et affichée 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.