Solo anteprima — attivazione richiesta

Costruire i download con DWTT

DWTT pubblica questa panoramica dell'integrazione per la pianificazione, non per l'esecuzione anonima. Il supporto deve approvare il flusso di lavoro del clip prima di emettere una chiave con ambito e la relativa quota di traffico.

DwttToolkitJSON su HTTPSLavori asincroniCredenziali con ambito

Quick start

DWTT rende facile la scansione dell'host API. La pagina inizia con credenziali attivate dal supporto, passa a un endpoint tenant assegnato e indica chiaramente un percorso di chiamata solo server.

URL del tenanthttps://dwtt.app

AutenticazioneX-API-Key: pending_activation_…

Profilo del clienteDwttToolkit

Versione dell'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 si avvicina alla sicurezza delle credenziali attraverso l'archiviazione segreta lato server, quindi nessuna incorporazione del bundle client.

Risolvere un collegamento

DWTT La pagina inizia con il rilevamento della fonte, passa ai formati da un URL inviato e afferma chiaramente che non ci sono uscite inventate.

POST/v1/resolveAmbito di applicazione: risolvere

Campo	Tipo	Obbligatorio	Descrizione
`source_link`	URL HTTPS	Sì	Pagina media pubblica o autorizzata da analizzare.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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

DWTT si avvicina all'identificatore di formato attraverso il valore restituito invariato, quindi alla disponibilità per collegamento.

Creare e seguire un processo di download

In DWTT, la preparazione asincrona viene prima di tutto quando si spiega la creazione di un Job.

POST/v1/jobsAmbito: posti di lavoro

Campo	Tipo	Obbligatorio	Descrizione
`source_link`	URL HTTPS	Sì	La stessa fonte normalizzata è stata inviata per la risoluzione.
`format_ref`	stringa	Sì	Un ID esatto dalla risposta di risoluzione.
`tenant`	stringa	No.	Dominio tenant assegnato. In genere omesso.

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 AccettatoSalva task_ref.

2Stato del sondaggioGET /v1/jobs/{task_ref} con la stessa chiave.

3ProntoAprire l'URL di download firmato.

Stato	Significato	Azione del cliente
`queued`	Ammesso alla coda limitata.	Sondaggio di nuovo con backoff.
`extracting`	Aggiornamento dei metadati di origine o della rotta.	Continua a sondare.
`processing`	Scaricare, remux o unire.	Visualizza il progresso del server.
`ready`	Il download firmato è disponibile.	Invia l'URL all'utente.
`failed`	Errore strutturato terminale.	Leggi `error_code`Riprova solo quando ti viene consigliato.
`expired`	L'uscita temporanea è stata rimossa.	Creare un nuovo lavoro.

curl https://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Per spiegare il Job polling, DWTT separa l'attesa iniziale di un secondo dal backoff limitato.

Errori prevedibili

Una busta non 2xx è il punto di partenza per il contratto Errore su DWTT. Un flusso di lavoro semplificato presenta quindi un ID di richiesta di supporto e spiega la gestione prevedibile del 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	Significato tipico	Azione
400	URL, corpo o formato non valido.	Correggi la richiesta. Risolvi di nuovo per i formati.
401	Chiave mancante, non valida, scaduta o con ambito errato.	Verificare le credenziali lato server.
403	Criterio di tenant o di origine ha rifiutato la richiesta.	Non aggirare la politica. Contattare l'assistenza.
404	Offerta di lavoro sconosciuta o scaduta.	Creare un nuovo lavoro, se del caso.
429	Richiesta o limite di lavori attivi raggiunto.	Onore `retry_after_seconds`.
503	Coda/capacità o upstream temporaneamente non disponibile.	Riprova con backoff esponenziale e jitter.

Contratto operativo

DWTT imposta le quote di traffico durante l'attivazione in modo che le integrazioni delle clip e le reti di origine non siano sovraccaricate.

Usa una logica applicativa idempotente e non avviare mai lavori duplicati per lo stesso clic dell'utente.
Memorizza brevemente i metadati di risoluzione, ma considera sempre le URL di download firmate come scadute.
Usa il backoff esponenziale limitato con jitter per 429, 503 e errori riprovabili.
Elabora solo media pubblici o media a cui sei autorizzato ad accedere. DRM e controlli di accesso non vengono bypassati.
Conserva gli ID delle richieste e gli ID dei lavori nei registri operativi privati. Non registrare inutilmente gli URL inviati.

DWTT rende l'accesso allo Schema facile da scansionare. La pagina inizia con l'attivazione prima dell'esplorazione, passa all'autenticazione assegnata e indica chiaramente le forme di richiesta documentate.

ACCESSO REVISO DALL'OPERATORE

Attivazione tramite supporto

Invia DWTT l'integrazione prevista, il volume di richieste probabile e le reti target. Indica se il cliente necessita di risoluzione, creazione di lavoro o entrambi, in modo che una chiave con ambito possa essere approvata e mostrata una sola volta.

Richiedi attivazione Le chiavi sono limitate all'inquilino, revocabili e rilasciate tramite il modulo di contatto. Gli script anonimi non possono eseguire lavori di download.