Tik peržiūra – reikia aktyvinti

Sukurkite atsisiuntimus su DWYT

DWYT kodo pavyzdžiai dokumentuoja būsimą užklausų seką. Gamybos skambučiai lieka uždaryti, kol vaizdo įrašo klientas bus peržiūrėtas ir operatoriaus priskirti kredencialai bus įjungti.

DwytFlowJSON per HTTPSAsinchroniniai darbaiApimties kredencialai

Greita pradžia

DWYT formato žemėlapyje peržiūrimi palaikymo suaktyvinti API pagrindinio kompiuterio kredencialai. Jis rodo priskirtą nuomininko galinį tašką šalia ir neužgožia tik serverio skambučio kelio.

Nuomotojo URLhttps://dwyt.app

Autentiškumo patvirtinimasX-API-Key: pending_activation_…

Kliento profilisDwytFlow

API versijav1

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

Kredencialų saugumui DWYT prasideda nuo slapto saugojimo serverio pusėje. Jo formato žemėlapis tai susieja su jokiu kliento paketų įterpimu ir baigiasi jokiais viešaisiais žurnalais ar saugyklomis.

Nuorodos išsprendimas

DWYT formato žemėlapis peržiūri šaltinio aptikimą operacijai "Resolve". Tai rodo formatus iš vieno pateikto URL šalia ir neužgožia jokių išrastų išvadų.

POST/v1/resolveTaikymo sritis: išspręsti

Laukas	Tipas	Būtinas	Aprašymas
`public_media`	HTTPS URL	Taip	Viešas arba įgaliotas žiniasklaidos puslapis analizuoti.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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

Formato identifikatoriui DWYT prasideda nuo grąžintos reikšmės nepakeistos. Jo formato žemėlapis susieja tai su prieinamumu pagal nuorodą ir baigiasi be spėjamos kokybės etiketės.

Atsisiuntimo užduoties kūrimas ir sekimas

Darbo sukūrimui DWYT tikrina asinchroninį pasirengimą prieš trumpą HTTP užklausą.Šis formato žemėlapis taip pat aiškiai parodo apribotą darbuotojo vykdymą.

POST/v1/jobsTaikymo sritis: darbo vietos

Laukas	Tipas	Būtinas	Aprašymas
`public_media`	HTTPS URL	Taip	Tas pats normalizuotas šaltinis pateiktas išspręsti.
`rendition_key`	eilutė	Taip	Tikslus ID iš atsakymo į sprendimą.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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 PriimtaIšsaugoti flow_id.

2Apklausos būsenaGET /v1/jobs/{flow_id} tuo pačiu raktu.

3ParuoštaAtidarykite pasirašytą atsisiuntimo URL.

Būsena	Reikšmė	Kliento veiksmas
`queued`	Priimtas į ribotą eilę.	Apklausa vėl su atgal.
`extracting`	Atnaujinami šaltinio metaduomenys arba maršrutas.	Tęskite apklausą.
`processing`	Parsisiuntimas, remiksas ar sujungimas.	Rodyti serverio pažangą.
`ready`	Pasirašytas atsisiuntimas yra prieinamas.	Siųsti URL vartotojui.
`failed`	Terminalo struktūrinė klaida.	Skaityti `error_code`Bandykite dar kartą tik tada, kai patartina.
`expired`	Laikinas išėjimas buvo pašalintas.	Sukurkite naują darbą.

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

Darbo apklausa prasideda vienos sekundės pradiniu laukimo laiku DWYT. Šis formato žemėlapis tada pateikia apribotą atgalinį atidėjimą. Galutinis faktas yra laikinas pasirašytas pristatymas.

Numatomos klaidos

DWYT tvarko Klaidos sutartį, pirmiausia nustatydamas vieną ne 2xx voką. Jis seka palaikymo užklausos ID ir išlaiko nuspėjamą kliento tvarkymą.

{
  "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ška reikšmė	Veiksmas
400	Netinkamas URL, tekstas arba negalimas formatas.	Ištaisykite užklausą. Išspręskite dar kartą formatams.
401	Trūksta, negalioja, pasibaigė galiojimo laikas arba neteisingos apimties raktas.	Patikrinkite serverio pusės kredencialus.
403	Nuomininkas arba šaltinio strategija atmetė užklausą.	Neaplenkite politikos. Susisiekite su palaikymo tarnyba.
404	Nežinomas arba pasibaigęs darbas.	Jei reikia, sukurkite naują darbą.
429	Pasiektas užklausos arba aktyvių užduočių limitas.	Garbė `retry_after_seconds`.
503	Eilė / talpa arba priešsroviui laikinai neprieinama.	Bandykite dar kartą su eksponentiniu atgal ir drebėjimu.

Veiklos sutartis

DWYT peržiūri integraciją prieš pasirinkdamas kvotas, kurios apsaugo tiek vaizdo klientą, tiek priešingos krypties paslaugas.

Naudokite idempotentinę programos logiką ir niekada nepradėkite pasikartojančių užduočių tam pačiam vartotojo paspaudimui.
Talpykloje trumpai išsprendžiami metaduomenys, tačiau visada pasirašyti atsisiuntimo URL laikomi pasibaigusiais.
Naudokite ribotą eksponentinį atgalinį atmetimą su drebėjimu, kad 429, 503 ir pakartotinai bandomos klaidos.
Apdorokite tik viešąją laikmeną arba laikmeną, prie kurios turite prieigą. DRM ir prieigos kontrolės priemonės nebus apeitos.
Saugokite užklausų ID ir užduočių ID privačiuose veiklos žurnaluose. Nereikia registruoti pateiktų URL be reikalo.

DWYT formato žemėlapis peržiūri aktyvavimą prieš žvalgymą Schemos prieigai. Jis rodo priskirtą autentifikavimą šalia ir neužgožia dokumentuotų užklausų formų.

EKSPLOATUOTOJO PERŽIŪRIMAS

Aktyvinkite per palaikymą

Paaiškinkite programą, kuri yra už užklausos, jos mėnesinio srauto įvertinimą ir vaizdo įrašų paslaugas, kurias ji naudos.DWYT peržiūri tas detales, priskiria reikiamus API leidimus ir neišlaiko jokios atkuriamos rakto vertės.

Prašykite aktyvavimo Raktai yra nuomininko apimties, atšaukiami ir išduodami per Susisiekite formą. Anoniminiai scenarijai negali vykdyti atsisiuntimo programos darbo.