Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med DWTT

DWTT publicerar denna integrationsöversikt för planering, inte anonym exekvering. Support måste godkänna klippflödet innan en avgränsad nyckel och dess trafikgräns utfärdas.

DwttToolkitJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

DWTT Sidan börjar med supportaktiverade autentiseringsuppgifter, flyttar till en tilldelad slutpunkt för innehavare och anger tydligt en anropsväg som endast gäller servern.

Webbadress till klienthttps://dwtt.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilDwttToolkit

API-versionv1

# 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 närmar sig Credential-säkerhet genom serverbaserad hemlighetslagring, utan inbäddning i klientpaket. Det effektiva arbetsflödet sparar inga offentliga loggar eller explicita arkiv.

Lösa en länk

DWTT gör Resolve-operationen lätt att skanna. Sidan börjar med källupptäckt, går vidare till format från en inskickad URL och anger tydligt att inga påhittade utdata förekommer.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`source_link`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

DWTT närmar sig formatidentifierare genom det returnerade värdet oförändrat, sedan tillgänglighet per länk. Det strömlinjeformade arbetsflödet håller ingen gissad kvalitetsmärkning explicit.

Skapa och följ ett nedladdningsjobb

I DWTT kommer asynkron förberedelse först när Jobbskapande förklaras. Det effektiva arbetsflödet följs av en kort HTTP-förfrågan och avslutas med begränsad arbetarexekvering.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`source_link`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`format_ref`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara task_ref.

2OmröstningsstatusGET /v1/jobs/{task_ref} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

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

För att förklara Job polling separerar DWTT en sekunds initial väntan från begränsad backoff. Ett strömlinjeformat arbetsflöde ger temporär signerad leverans en egen plats.

Förutsägbara fel

Ett icke-2xx kuvert är startpunkten för Felkontrakt på DWTT. Ett strömlinjeformat arbetsflöde presenterar sedan ett supportförfrågnings-ID och förklarar förutsägbar klienthantering.

{
  "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	Typisk betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

DWTT ställer in trafiktillstånd under aktivering så att klippintegreringar och källnätverk inte överbelastas.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

DWTT gör Schema-åtkomst lätt att skanna. Sidan börjar med aktivering innan utforskning, går vidare till tilldelad autentisering och anger tydligt dokumenterade förfrågningsformat.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Skicka till DWTT den avsedda integrationen, sannolik förfrågningsvolym och mål-nätverk. Ange om klienten behöver upplösning, jobbskapande eller båda så att en avgränsad nyckel kan godkännas och visas när den är klar.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.