Samo predogled – zahteva se aktivacija

Graditi prenose z DWYT

Vzorec kode DWYT dokumentira prihodnji zaporedje zahtev. Klici v produkciji ostajajo zaprti, dokler video odjemalec ni pregledan in omogočene poverilnice, dodeljene operaterju.

DwytFlowJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

Zemljevid formata DWYT pregleda poverilnice, aktivirane s podporo, za gostitelja API. Prikaže dodeljeno končno točko najemnika in ne zakriva poti klicev samo za strežnik.

URL najemnikahttps://dwyt.app

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaDwytFlow

Različica API-jav1

# 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"}'

Za varnost poverilnic DWYT začne s shranjevanjem skrivnosti na strežniški strani. Njegov zemljevid formatov to povezuje z ne vgrajevanjem paketov na odjemalski strani in se konča brez javnih dnevnikov ali repozitorijev.

Reši povezavo

DWYT-jev format map pregleduje zaznavanje vira za operacijo Resolve. Prikazuje formate iz enega predloženega URL-ja naslednjega in ne zastira nobenih izumljenih izhodov.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`public_media`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

Za identifikator formata DWYT začne z vrnjeno vrednostjo nespremenjeno. Njegova karta formatov to povezuje z razpoložljivostjo na povezavo in se konča brez domnevne oznake kakovosti.

Ustvarjanje in spremljanje opravila prenosa

Za ustvarjanje delovnih mest DWYT preverja asinhrono pripravo pred kratkim HTTP zahtevkom. Ta zemljevid formatov prav tako jasno prikazuje omejeno izvajanje delavcev.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`public_media`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`rendition_key`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

2Stanje anketeGET /v1/jobs/{flow_id} z istim ključem.

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

curl https://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

Na DWYT se začetek preverjanja nalog začne z eno sekundo začetnega čakanja. Ta zemljevid formatov nato prikazuje omejeno vračanje nazaj. Končni podatek je začasna podpisana dostava.

Predvidljive napake

DWYT obravnava pogodbo o napaki tako, da najprej identificira eno ovojnico, ki ni 2xx. Sledi z ID-jem zahteve za podporo in ohranja predvidljivo obravnavo odjemalca v pogledu.

{
  "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	Tipičen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

DWYT pregleda integracijo, preden izbere kvote, ki ščitijo tako video odjemalca kot tudi zgornje storitve.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

Karta formatov DWYT pregleda aktivacijo pred raziskovanjem dostopa do Sheme. Nato prikaže dodeljeno avtentikacijo in ne prikriva dokumentiranih oblik zahtev.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Pojasnite aplikacijo za zahtevo, njeno ocenjeno mesečno prometno količino in video storitve, ki jih bo uporabljala. DWYT pregleda te podrobnosti, dodeli potrebna dovoljenja API in ne hrani nobene obnovljive vrednosti ključa.

Zahtevajte aktivacijo Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.