Kun prøveversion — aktivering kræves

Byg downloads med DWYT

DWYT kodeeksempler dokumenterer den fremtidige anmodningssekvens. Produktionsopkald forbliver lukkede indtil videoklienten er gennemgået og operatørtildelte legitimationsoplysninger er aktiveret.

DwytFlowJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

DWYT: formatkort gennemgår supportaktiverede legitimationsoplysninger for API-vært. Det viser en tildelt lejerendepunkt næste og skjuler ikke en server-only opkaldssti.

Lejer- URLhttps://dwyt.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientDwytFlow

Version af APIv1

# 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 legitimationssikkerhed begynder DWYT med server-side hemmelig lagring. Dens formatkort parrer dette med ingen klientpakkeindlejring og slutter med ingen offentlige logfiler eller arkiver.

Løsning af et link

DWYT: formatkort gennemgår kildedetektion for Resolve-operationen. Det viser formater fra en indsendt URL næste og skjuler ikke opfundne output.

POST/v1/resolveOmfang: løse

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

For formatidentifikator begynder DWYT med den returnerede værdi uændret. Dets formatkort parrer det med tilgængelighed pr. link og slutter uden gættet kvalitetsmærke.

Opret og følg et downloadjob

Ved oprettelse af job kontrollerer DWYT asynkron forberedelse før en kort HTTP-anmodning. Dette formatkort gør også begrænset arbejdsudførelse klar.

POST/v1/jobsOmfang: job

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

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

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

Job polling begynder med et sekunds indledende ventetid på DWYT. Dette formatkort præsenterer derefter begrænset tilbageholdelse. Det endelige faktum er midlertidig underskrevet levering.

Forudsigelige fejl

DWYT håndterer Fejlkontakt ved først at identificere en ikke-2xx konvolut. Den fortsætter med en supportanmodnings-ID og holder forudsigelig klienthåndtering i fokus.

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

DWYT gennemgår integrationen, før der vælges kvoter, der beskytter både videoklienten og upstream-tjenesterne.

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.

DWYT: formatkort gennemgår aktivering før udforskning for Skemaadgang. Det viser tildelt autentificering næste og skjuler ikke dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Forklar applikationen bag anmodningen, dens månedlige trafikestimat og de videotjenester, den vil bruge. DWYT gennemgår disse detaljer, tildeler de nødvendige API-tilladelser og gemmer ingen genoprettelige nøgleværdier.

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