Numai previzualizare — activare necesară

Construiți descărcări cu DWTT

DWTT publică această schiță de integrare pentru planificare, nu pentru executare anonimă. Suportul trebuie să aprobe fluxul de lucru pentru clip înainte de a emite o cheie cu domeniu limitat și alocația sa de trafic.

DwttToolkitJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

DWTT face ca gazda API să fie ușor de scanat. Pagina începe cu acreditări activate pentru asistență, trece la un punct final de tenant alocat și precizează clar o cale de apel doar de server.

URL- ul entității găzduitehttps://dwtt.app

AutentificareX-API-Key: pending_activation_…

Profilul de clientDwttToolkit

Versiune 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 abordează siguranța acreditărilor prin stocarea secretelor pe server, fără încorporare în pachetul clientului. Fluxul de lucru simplificat nu păstrează jurnale publice sau depozite explicite.

Rezolvarea unui link

DWTT face operațiunea Resolve ușor de scanat. Pagina începe cu detectarea sursei, trece la formatele provenite dintr-un singur URL trimis și precizează clar că nu există rezultate inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`source_link`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

DWTT abordează identificatorul de format prin valoarea returnată neschimbată, apoi prin disponibilitatea pentru fiecare link. Fluxul de lucru simplificat nu păstrează explicit nicio etichetă de calitate presupusă.

Crearea și urmărirea unei lucrări de descărcare

În DWTT, pregătirea asincronă vine prima atunci când se explică crearea Jobului. Acest flux de lucru simplificat este urmat de o scurtă cerere HTTP și se încheie cu execuția limitată a workerului.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`source_link`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`format_ref`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei 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 AcceptatSalvează task_ref.

2Starea sondajuluiGET /v1/jobs/{task_ref} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

Pentru a explica interogarea Job, DWTT separă așteptarea inițială de o secundă de backoff-ul plafonat. Un flux de lucru simplificat oferă livrării temporare semnate propriul loc.

Erori previzibile

Un plic non-2xx este punctul de plecare pentru contractul de eroare pe DWTT. Un flux de lucru simplificat prezintă apoi un ID al solicitării de suport și explică gestionarea previzibilă a clientului.

{
  "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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

DWTT stabilește alocările de trafic în timpul activării, astfel încât integrările clipurilor și rețelele sursă să nu fie supraîncărcate.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

DWTT face accesul la Schema ușor de scanat. Pagina începe cu activarea înainte de explorare, trece la autentificarea atribuită și prezintă clar formele de cerere documentate.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Trimiteți către DWTT integrarea vizată, probabil volumul solicitărilor și rețelele țintă. Menționați dacă clientul are nevoie de rezoluție, creare de job sau de ambele, astfel încât o cheie cu domeniu restrâns să poată fi aprobată și afișată o singură dată.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.