Kun prøveversion — aktivering kræves

Byg downloads med DWTT

DWTT offentliggør denne integrationsoversigt til planlægning, ikke anonym udførelse. Support skal godkende klip-arbejdsgangen, før der udstedes en scoped nøgle og dens trafikkvote.

DwttToolkitJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

DWTT gør API-værten nem at scanne. Siden starter med supportaktiverede legitimationsoplysninger, går videre til en tildelt lejer-endpoint og angiver tydeligt en server-only kaldsti.

Lejer- URLhttps://dwtt.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientDwttToolkit

Version af 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 håndterer legitimationssikkerhed gennem server-side hemmelig opbevaring, uden klientpakkeindlejring. Den strømlinede arbejdsgang gemmer ingen offentlige logs eller eksplicitte arkiver.

Løsning af et link

DWTT Siden starter med kildedetektering, går videre til formater fra én indsendt URL, og angiver tydeligt, at der ikke er opfundet nogen output.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`source_link`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

DWTT nærmer sig Format identifikator gennem den returnerede værdi uændret, derefter pr. Link tilgængelighed. Den strømlinede arbejdsgang holder ingen gættet kvalitetsmærke eksplicit.

Opret og følg et downloadjob

I DWTT kommer asynkron forberedelse først, når Joboprettelse forklares. Den strømlinede arbejdsgang følges af en kort HTTP-anmodning og afsluttes med begrænset arbejderekskution.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`source_link`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`format_ref`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

2AfstemningsstatusGET /v1/jobs/{task_ref} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

For at forklare Job polling, DWTT adskiller et sekund indledende ventetid fra capped backoff. En strømlinet arbejdsgang giver midlertidig underskrevet levering sit eget sted.

Forudsigelige fejl

En ikke-2xx kuvert er udgangspunktet for Fejlkontakt på DWTT. En strømlinet arbejdsgang præsenterer derefter en supportanmodnings-ID og forklarer forudsigelig klienthåndtering.

{
  "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 betydning	Handling
400	Ugyldig URL, brødtekst eller utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

DWTT indstiller trafiktilladelser under aktivering, så klipintegrationer og kildenetværk ikke overbelastes.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

DWTT gør Schema-adgang nem at scanne. Siden starter med aktivering før udforskning, går videre til tildelt autentificering og angiver klart dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Send DWTT den tilsigtede integration, sandsynligt anmodningsvolumen og målnetværk. Nævn om klienten har brug for opløsning, joboprettelse eller begge dele, så en afgrænset nøgle kan godkendes og vises én gang.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.