Ainult eelvaade – nõutav aktiveerimine

Ehitage allalaadimised koos DWYT-ga

DWYT koodinäited dokumenteerivad tulevase päringute jada. Tootmiskutsed jäävad suletuks, kuni videoklient on üle vaadatud ja operaatori määratud volitused on lubatud.

DwytFlowJSON HTTPS-i kauduAsünkroonsed töökohadKohaldamisalaga identimisteave

Kiire algus

DWYT vormikaardi ülevaated toetuse aktiveeritud volitusi API hosti jaoks. See näitab määratud rentniku lõpp-punkti järgmisena ega varja serveripoolset kutsumisrada.

Rentniku URLhttps://dwyt.app

AutentimineX-API-Key: pending_activation_…

Kliendi profiilDwytFlow

API versioonv1

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

Volituste turvalisuse tagamiseks algab DWYT serveripoolse salajase salvestusega. Selle vormingukaart seob selle kliendipoolse paketi manustamise puudumisega ja lõpeb avalike logide või hoidlate puudumisega.

Lingi lahendamine

DWYT'i vormingukaart vaatab üle lähte tuvastamise Resolve'i toimingu jaoks. See näitab ühe esitatud URL-i vorminguid järgmisena ega varja ühtegi väljamõeldud väljundit.

POST/v1/resolveReguleerimisala: lahendada

Väli	Tüüp	Nõutav	Kirjeldus
`public_media`	HTTPS URL	Jah	Avalik või volitatud meedia leht analüüsimiseks.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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

Formaaditunnuse puhul algab DWYT tagastatud väärtusega muutmata kujul. Selle vormingukaart seob selle lingipõhise saadavusega ja lõpeb ilma oletatud kvaliteedimärgistuseta.

Allalaadimistöö loomine ja jälgimine

Töö loomise jaoks kontrollib DWYT enne lühikest HTTP-päringut asünkroonset ettevalmistust. See vormingukaart teeb ka piiratud töötaja täitmise selgeks.

POST/v1/jobsReguleerimisala: töökohad

Väli	Tüüp	Nõutav	Kirjeldus
`public_media`	HTTPS URL	Jah	Sama normaliseeritud allikas esitati lahendamiseks.
`rendition_key`	string	Jah	Täpne ID lahendamisvastusest.
`tenant`	string	Ei	Määratud rentniku domeen. Tavaliselt jäetakse välja.

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

2Küsitluse staatusGET /v1/jobs/{flow_id} sama võtmega.

3ValmisAvage allkirjastatud allalaadimise URL.

Olek	Tähendus	Kliendi tegevus
`queued`	Lubatud piiratud järjekorda.	Küsitlus uuesti tagasilöögiga.
`extracting`	Värskendatakse lähtemetaadata või marsruuti.	Jätkake küsitlemist.
`processing`	Allalaadimine, remuxing või ühendamine.	Kuva serveri edenemine.
`ready`	Allkirjastatud allalaadimine on saadaval.	Saada URL kasutajale.
`failed`	Terminali struktureeritud viga.	Loe `error_code`Proovige uuesti ainult siis, kui seda soovitatakse.
`expired`	Ajutine väljund eemaldati.	Looge uus töökoht.

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

Töö päring algab ühe sekundi esialgse ootusega DWYT-l. See vormingukaart esitab seejärel piiratud tagasimineku. Viimane fakt on ajutine allkirjastatud edastamine.

Eeldatavad vead

DWYT käsitleb Error lepingut, tuvastades esmalt ühe mitte-2xx ümbriku. See järgneb tuginõude ID-ga ja hoiab ennustatavat kliendikäsitlust silmas.

{
  "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	Tüüpiline tähendus	Tegevus
400	Vigane URL, keha või kättesaamatu vorming.	Parandage taotlus. Lahendage uuesti vormingute jaoks.
401	Puuduv, kehtetu, aegunud või vale ulatusega võti.	Kontrollige serveripoolset mandaati.
403	Üürnik või allikapoliitika lükkas taotluse tagasi.	Ärge mööduge poliitikast. Võtke ühendust toega.
404	Tundmatu või aegunud töö.	Looge vajadusel uus töökoht.
429	Taotluste või aktiivsete tööde piirmäär on saavutatud.	Au. `retry_after_seconds`.
503	Järjekord/mahutavus või ülesvoolu ajutiselt kättesaamatu.	Proovige uuesti eksponentsiaalse tagasilöögi ja värisemisega.

Tegevusleping

DWYT vaatab integratsiooni üle enne kvootide valimist, mis kaitsevad nii videoklienti kui ka ülesvoolu teenuseid.

Kasutage idempotentset rakendusloogikat ja ärge kunagi käivitage sama kasutaja kliki jaoks duplikaattöid.
Puhverda lahendamise metaandmeid lühidalt, kuid käsitle allkirjastatud allalaadimise URL-e alati kui aeguvat.
Kasutage piiratud eksponentsiaalset tagasilööki koos värisemisega 429, 503 ja korratavaid vigu.
Töötle ainult avalikku meediat või meediat, millele sul on lubatud juurde pääseda. DRM- ja juurdepääsukontrolle ei mööda.
Hoidke päringute ID-d ja tööde ID-d privaatses operatiivlogides. Ärge logige esitatud URL-e tarbetult.

DWYT vormikaart vaatab aktiveerimise üle enne Schema juurdepääsu uurimist. See näitab määratud autentimist järgmisena ega varja dokumenteeritud päringukujusid.

ETTEVÕTJA LÄBIVAATAMINE

Aktiveerimine tugiteenuse kaudu

Selgita päringu taga olevat rakendust, selle kuu liikluse hinnangut ja videoteenuseid, mida see kasutab. DWYT vaatab need üksikasjad üle, määrab vajalikud API õigused ja ei säilita taastatavat võtmeväärtust.

Taotle aktiveerimist Võtmed on üürniku ulatuses, tühistatavad ja väljastatakse kontaktivormi kaudu. Anonüümsed skriptid ei saa alla laadija tööd käivitada.