Alleen voorbeeld — activering vereist

Bouw downloads met DWTT

DWTT publiceert deze integratie-omschrijving voor planning, niet voor anonieme uitvoering. Ondersteuning moet de clip-workflow goedkeuren voordat een gescopeerde sleutel en het bijbehorende verkeersbudget worden uitgegeven.

DwttToolkitVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

DWTT maakt het gemakkelijk om API-host te scannen. De pagina begint met ondersteuning-geactiveerde referenties, gaat over naar een toegewezen tenant-eindpunt en vermeldt duidelijk een server-only oproeppad.

URL van tenanthttps://dwtt.app

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantDwttToolkit

API-versiev1

# 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 benadert Credential-beveiliging via server-side geheime opslag, zonder client-bundel embedding. De gestroomlijnde workflow houdt geen openbare logs of expliciete repositories bij.

Een koppeling oplossen

DWTT maakt Resolve-operaties gemakkelijk scanbaar. De pagina begint met bronherkenning, gaat over naar formaten van één ingediende URL, en vermeldt duidelijk dat er geen verzonnen uitvoer is.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`source_link`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

DWTT benadert Formaatidentificatie via de ongewijzigde geretourneerde waarde, daarna beschikbaarheid per link. De gestroomlijnde workflow houdt geen geraden kwaliteitslabel expliciet.

Maak en volg een downloadtaak

In DWTT komt asynchrone voorbereiding eerst aan bod bij het uitleggen van Jobcreatie. Die gestroomlijnde workflow volgt met een korte HTTP-aanvraag en sluit af met begrensde worker-uitvoering.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`source_link`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`format_ref`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

2Poll status 1GET /v1/jobs/{task_ref} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

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

Om Job polling uit te leggen, scheidt DWTT de initiële wachttijd van één seconde van begrensde backoff. Een gestroomlijnde workflow geeft tijdelijke ondertekende levering een eigen plaats.

Voorspelbare fouten

Een niet-2xx envelop is het startpunt voor het Error-contract op DWTT. Een gestroomlijnde workflow presenteert vervolgens een ondersteuningsverzoek-ID en legt voorspelbare clientafhandeling uit.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

DWTT stelt verkeersrechten in tijdens de activering, zodat clipintegraties en bronnetwerken niet overbelast raken.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

DWTT maakt Schema-toegang gemakkelijk scanbaar. De pagina begint met activatie vóór verkenning, gaat over naar toegewezen authenticatie en vermeldt duidelijk gedocumenteerde aanvraagvormen.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Stuur DWTT de beoogde integratie, waarschijnlijk verzoekvolume en doelnetwerken. Vermeld of de cliënt resolutie, taakcreatie of beide nodig heeft, zodat een afgebakende sleutel kan worden goedgekeurd en getoond.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.