Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med DWYT

DWYT-kodeeksemplene dokumenterer fremtidig forespørselssekvens. Produksjonsanrop forblir lukket til videoklienten er gjennomgått og operatørtildelte legitimasjoner er aktivert.

DwytFlowJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

DWYT: formatkart vurderer støtte-aktiverte legitimasjoner for API-vert. Den viser en tildelt leietakerendepunkt neste og skjuler ikke en server-kun kallbane.

Leietaker-URLhttps://dwyt.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilDwytFlow

API-versjonv1

# Available only after support activation
export DWYT_FLOW_SECRET="issued-after-review"

curl -X POST https://dwyt.app/v1/resolve \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID"}'

For legitimasjonssikkerhet begynner DWYT med server-side hemmelig lagring. Dets formatkart kombinerer dette med ingen klientpakke-innbygging og avsluttes med ingen offentlige logger eller arkiver.

Løse en kobling

DWYT s formatkart gjennomgår kildeoppdagelse for Resolve-operasjon. Det viser formater fra en innsendt URL neste og skjuler ikke noen oppfunnet utganger.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`public_media`	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
}

For formatidentifikator starter DWYT med den returnerte verdien uendret. Dets formatkart parer dette med tilgjengelighet per lenke og avsluttes uten antatt kvalitetsmerke.

Opprett og følg en nedlastingsjobb

For jobboppretting kontrollerer DWYT asynkron forberedelse før en kort HTTP-forespørsel. Dette formatkartet gjør også begrenset arbeidsutførelse tydelig.

POST/v1/jobsOmfang: jobber

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

curl -X POST https://dwyt.app/v1/jobs \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID","rendition_key":"18"}'

1202 AkseptertLagre@ action: button flow_id.

2AvstemningsstatusGET /v1/jobs/{flow_id} 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://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

Jobbpolling begynner med ett sekunds innledende ventetid på DWYT. Dette formatkartet presenterer deretter begrenset tilbakeslag. Det endelige faktum er midlertidig signert levering.

Forutsigbare feil

DWYT håndterer feilkontrakt ved først å identifisere en ikke-2xx-konvolutt. Det følger med en støtteforespørsels-ID og holder forutsigbar klienthåndtering i sikte.

{
  "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

DWYT vurderer integrasjonen før valg av kvoter som beskytter både videoklienten og oppstrøms tjenester.

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.

DWYT sin formatkart gjennomgår aktivering før utforskning for Schema-tilgang. Det viser tildelt autentisering neste og skjuler ikke dokumenterte forespørselsformer.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Forklar applikasjonen bak forespørselen, dens estimerte månedlige trafikk og videotjenestene den vil bruke. DWYT gjennomgår disse detaljene, tildeler nødvendige API-tillatelser og beholder ingen gjenopprettbar nøkkelverdi.

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