Tikai priekšskatījums — nepieciešama aktivizācija

Veidojiet lejupielādes ar DWYT

DWYT koda piemēri dokumentē nākotnes pieprasījumu secību. Ražošanas zvani paliek slēgti, līdz video klients tiek pārskatīts un operatora piešķirtās akreditācijas tiek aktivizētas.

DwytFlowJSON, izmantojot HTTPSAsinhronie darbiAptvertie akreditācijas dati

Ātrās sākšanas rokasgrāmata

DWYT formāta karte pārskata atbalstītas akreditācijas API saimniekam. Tā parāda piešķirto nomnieka galapunktu un neslēpj tikai servera zvana ceļu.

Nomnieka URLhttps://dwyt.app

AutentifikācijaX-API-Key: pending_activation_…

Klienta profilsDwytFlow

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

Drošības nolūkos DWYT sākas ar servera puses slepeno glabāšanu. Tā formāta karte savieno to ar klienta pakotnes neiekļaušanu un beidzas bez publiskiem žurnāliem vai repozitorijiem.

Saites atrisināšana

DWYT formāta karte pārskata avota noteikšanu Resolve operācijai. Tā parāda formātus no viena iesniegtā URL un neslēpj nevienu izgudrotu izvadi.

PAST/v1/resolveDarbības joma: atrisināt

Lauks	Tips	Nepieciešams	Apraksts
`public_media`	HTTPS URL	Jā	Publiska vai pilnvarota mediju lapa analīzei.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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

Formāta identifikatoram DWYT sākas ar atgriezto vērtību nemainītu. Tās formāta karte savieno to ar pieejamību katrā saitē un beidzas bez minētas kvalitātes atzīmes.

Izveidot un sekot lejupielādes uzdevumam

Darba izveidei DWYT pārbauda asinhrono sagatavošanu pirms īsa HTTP pieprasījuma. Šī formāta karte arī skaidri parāda ierobežotas darbinieku izpildes.

PAST/v1/jobsDarbības joma: darba vietas

Lauks	Tips	Nepieciešams	Apraksts
`public_media`	HTTPS URL	Jā	Tika iesniegts tas pats normalizētais avots, lai atrisinātu.
`rendition_key`	virkne	Jā	Precīzs ID no atrisināšanas atbildes.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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 PieņemtsSaglabāt flow_id.

2Aptaujas statussGET /v1/jobs/{flow_id} ar to pašu atslēgu.

3GatavsAtvērt parakstīto lejupielādes URL.

Statuss	Nozīme	Klienta darbība
`queued`	Iesniegts ierobežotajā rindā.	Aptauja vēlreiz ar atkāpšanos.
`extracting`	Avota metadatu vai maršruta atsvaidzināšana.	Turpiniet aptauju.
`processing`	Lejupielāde, pārkodēšana vai apvienošana.	Parādīt servera progresu.
`ready`	Parakstīta lejupielāde ir pieejama.	Nosūtiet vietrādi URL lietotājam.
`failed`	Termināla strukturēta kļūda.	Lasīt `error_code`Atkārtojiet mēģinājumu tikai tad, kad ieteicams.
`expired`	Pagaidu izvade tika noņemta.	Izveidojiet jaunu darbu.

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

Darba aptauja sākas ar vienas sekundes sākotnējo gaidīšanu uz DWYT. Šī formāta karte pēc tam piedāvā ierobežotu atkāpšanos. Galīgais fakts ir pagaidu parakstīta piegāde.

Paredzamās kļūdas

DWYT apstrādā kļūdu līgumu, vispirms identificējot vienu ne-2xx aploksni. Tam seko atbalsta pieprasījuma ID un tiek saglabāta paredzama klienta apstrāde.

{
  "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	Tipiska nozīme	Darbība
400	Nederīgs URL, pamatteksts vai nepieejams formāts.	Labojiet pieprasījumu. Mēģiniet vēlreiz formātiem.
401	Trūkst, nederīgs, beidzies vai nepareiza darbības joma atslēga.	Pārbaudīt servera puses akreditācijas datus.
403	Nomnieka vai avota politika noraidīja pieprasījumu.	Nepārkāpiet politiku. Sazinieties ar atbalstu.
404	Nezināms vai beidzies darba laiks.	Ja nepieciešams, izveidojiet jaunu uzdevumu.
429	Sasniegts pieprasījumu vai aktīvo darbu ierobežojums.	Gods `retry_after_seconds`.
503	Rinda/kapacitāte vai augšupejošais savienojums pagaidām nav pieejams.	Atkārtoti mēģiniet ar eksponenciālu atpakaļejošu aizkavi un traucējumiem.

Darbības līgums

DWYT pārskata integrāciju pirms kvotu izvēles, kas aizsargā gan video klientu, gan augšupvērstos pakalpojumus.

Izmantojiet idempotent lietojumprogrammu loģiku un nekad nesāciet dublēt darbus vienam un tam pašam lietotāja klikšķim.
Kešatmiņa īsi atrisina metadatus, bet vienmēr uzskata, ka parakstītie lejupielādes URL ir beigušies.
Izmantojiet ierobežotu eksponenciālo atpakaļejošo aizkavi ar nejaušību 429, 503 un atkārtojamām kļūdām.
Apstrādājiet tikai publisku multividi vai multividi, kurai jums ir piekļuve. DRM un piekļuves kontroles netiek apietas.
Saglabājiet pieprasījumu ID un darba ID privātos darbības žurnālos. Nelietojiet iesniegtos URL nevajadzīgi.

DWYT formāta karte pārskata aktivizāciju pirms shēmas piekļuves izpētes. Tā parāda piešķirto autentifikāciju nākamajā solī un nepārklāj dokumentētos pieprasījuma veidus.

EKSPLUATANTA PĀRBAUDĪTA PIEKĻUVE

Aktivizēšana, izmantojot atbalstu

Izskaidrojiet pieprasījuma pamatā esošo lietojumprogrammu, tās ikmēneša trafika aplēsi un video pakalpojumus, ko tā izmantos. DWYT pārskata šos datus, piešķir nepieciešamās API atļaujas un neuzglabā atgūstamu atslēgas vērtību.

Pieprasīt aktivizāciju Atslēgas ir īrnieka mērogā, atsaucamas un izsniegtas caur Kontaktformu. Anonīmi skripti nevar izpildīt lejupielādētāja darbu.