Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med DWTT

DWTT publiserer denne integrasjonsskissen for planlegging, ikke anonym utførelse. Support må godkjenne klipp arbeidsflyten før du utsteder en nøkkel med omfang og dens trafikk tildeling.

DwttToolkitJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

DWTT Siden starter med brukerstøtteaktivert legitimasjon, går til et tilordnet sluttpunkt for leieren og angir tydelig en anropsbane som bare gjelder for serveren.

Leietaker-URLhttps://dwtt.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilDwttToolkit

API-versjonv1

# 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ærmer seg Credential-sikkerhet gjennom hemmelig lagring på serversiden, og deretter ingen klientbunt-innbygging. Den strømlinjeformede arbeidsflyten holder ingen offentlige logger eller repositorier eksplisitt.

Løse en kobling

DWTT Siden starter med kildegjenkjenning, går videre til formater fra én innsendt URL, og det står tydelig at det ikke er oppfunnet utdata.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`source_link`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

DWTT nærmer seg Formatidentifikator gjennom den returnerte verdien uendret, deretter per-link tilgjengelighet. Den strømlinjeformede arbeidsflyten holder ingen gjettet kvalitetsetikett eksplisitt.

Opprett og følg en nedlastingsjobb

I DWTT kommer asynkron forberedelse først når du forklarer Jobboppretting. Den strømlinjeformede arbeidsflyten følger med en kort HTTP-forespørsel og lukkes på begrenset arbeidsutførelse.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`source_link`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`format_ref`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button task_ref.

2AvstemningsstatusGET /v1/jobs/{task_ref} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

For å forklare jobbavstemning skiller DWTT ett sekunds innledende ventetid fra en begrenset tilbakestilling. En strømlinjeformet arbeidsflyt gir midlertidig signert levering sin egen plass.

Forutsigbare feil

En ikke-2xx-konvolutt er utgangspunktet for Feil kontrakt på DWTT. En strømlinjeformet arbeidsflyt presenterer deretter en støtteforespørsel-ID og forklarer forutsigbar 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 utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

DWTT angir trafikktillatelser under aktivering, slik at klippeintegrasjoner og kildenettverk ikke overbelastes.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

DWTT gjør Schema-tilgang enkel å skanne. Siden starter med aktivering før utforskning, går videre til tilordnet autentisering, og angir tydelig dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Send DWTT den tiltenkte integrasjonen, sannsynlig forespørselsvolum og målrettede nettverk. Nevn om klienten trenger oppløsning, jobbopprettelse eller begge deler slik at en avgrenset nøkkel kan godkjennes og vises når.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.