Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s DWYT

Kôdni primjeri DWYT dokumentiraju budući slijed zahtjeva. Produkcijski pozivi ostaju zatvoreni dok se video-klijent ne pregleda i ne omoguće vjerodajnice dodijeljene od strane operatera.

DwytFlowJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

Pregledi karte formata DWYT-a podržavaju aktivirane vjerodajnice za API host. Prikazuje sljedeću dodijeljenu krajnju točku zakupca i ne prikriva put poziva samo za poslužitelj.

URL klijentahttps://dwyt.app

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaDwytFlow

Verzija 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 sigurnost vjerodajnica, DWYT počinje sa server-side tajnim pohranom. Njegova mapa formata to uparuje s bez ugradnje client bundlea i završava s bez javnih zapisa ili repozitorija.

Rješavanje veze

Mapa formata DWYT-a pregledava otkrivanje izvora za radnju Resolve. Prikazuje formate iz jednog poslanog URL-a sljedeći i ne prikriva nikakve izmišljene izlaze.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`public_media`	HTTPS URL	Da	Javna ili ovlaštena medijska stranica za analizu.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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

Za identifikator formata, DWYT počinje s vraćenom vrijednošću nepromijenjenom. Njegova karta formata to povezuje s dostupnošću po poveznici i završava bez pretpostavljene oznake kvalitete.

Stvaranje i praćenje zadatka preuzimanja

Za stvaranje posla, DWYT provjerava asinkonu pripremu prije kratkog HTTP zahtjeva. Ova mapa formata također jasno prikazuje ograničeno izvršavanje radnika.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`public_media`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`rendition_key`	string	Da	Točan ID iz odgovora na rješavanje.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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 PrihvaćenoSpremi flow_id.

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

3SpremniOtvorite potpisani URL za preuzimanje.

Status	Značenje	Akcija klijenta
`queued`	Prihvaćeno u ograničeni red.	Ponovno anketiranje s odmakom.
`extracting`	Osvježavanje izvornih metapodataka ili rute.	Nastavite s glasovanjem.
`processing`	Preuzimanje, remiksanje ili spajanje.	Prikaz napretka poslužitelja.
`ready`	Potpisano preuzimanje je dostupno.	Pošaljite URL korisniku.
`failed`	Terminal strukturirana pogreška.	Pročitajte `error_code`. Ponovite samo kada se savjetuje.
`expired`	Privremeni izlaz je uklonjen.	Stvorite novi posao.

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

Ispitivanje posla započinje početnim čekanjem od jedne sekunde na DWYT. Ova karta formata zatim prikazuje ograničeni eksponencijalni odmak. Završna činjenica je privremena isporuka s potpisom.

Predvidljive pogreške

DWYT obrađuje Error contract tako što najprije identificira jedan omot koji nije 2xx. Zatim slijedi ID zahtjeva za podršku i zadržava predvidljivo rukovanje na strani klijenta u vidu.

{
  "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čno značenje	Akcija
400	Nevažeći URL, tijelo ili nedostupan format.	Ispravite zahtjev. Resolvirajte ponovno za formate.
401	Ključ nedostaje, nije valjan, istekao je ili ima pogrešan opseg.	Provjerite vjerodajnice na strani poslužitelja.
403	Zahtjev je odbio stanar ili izvorno pravilo.	Nemojte zaobići pravilnik. Kontaktirajte podršku.
404	Nepoznat ili istekao posao.	Stvorite novi posao ako je to prikladno.
429	Dostignuto je ograničenje zahtjeva ili aktivnih zadataka.	Čast `retry_after_seconds`.
503	Red čekanja/kapaciteta ili upstream privremeno nedostupan.	Pokušajte ponovno s eksponencijalnim backoff i jitter.

Ugovor o radu

DWYT pregledava integraciju prije odabira kvota koje štite i video klijent i usluge uzvodno.

Koristite idempotentnu logiku aplikacije i nikada ne pokrenite duplicirane poslove za isti klik korisnika.
Predmemorija rješava metapodatke kratko, ali uvijek tretira potpisane URL-ove za preuzimanje kao isteka.
Koristite ograničeni eksponencijalni backoff s jitterom za 429, 503 i ponovljive pogreške.
Obrađujte samo javne medije ili medije za koje imate ovlaštenje pristupa. DRM i kontrole pristupa nisu zaobiđene.
ID-ove zahtjeva i ID-ove poslova čuvajte u privatnim operativnim zapisnicima. Nemojte nepotrebno bilježiti poslane URL-ove.

Mapa formata DWYT pregledava aktivaciju prije istraživanja za pristup shemi. Prikazuje dodijeljenu autentifikaciju sljedeću i ne zakriva dokumentirane oblike zahtjeva.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Objasnite aplikaciju iza zahtjeva, njezinu procjenu mjesečnog prometa i video usluge koje će koristiti. DWYT pregledava te pojedinosti, dodjeljuje potrebna API dopuštenja i ne zadržava nikakvu moguće obnovivu vrijednost ključa.

Zatražite aktivaciju Ključevi su ograničeni na zakupca, opozivi su mogući i izdaju se putem obrasca za kontakt. Anonimni skripti ne mogu izvršavati preuzimanje radova.