Réamhamharc amháin — gníomhachtú de dhíth

Tóg íoslódálacha le DWYT

Déanann na samplaí cód DWYT doiciméadú ar sheicheamh na hiarrata amach anseo. Fanann glaonna táirgthe dúnta go dtí go ndéantar athbhreithniú ar an gcliant físe agus go gcuirtear dintiúir sannta ag an oibreoir ar siúl.

DwytFlowJSON thar HTTPSJabanna AisioncrónachaDintiúir scóip

Tús tapa

Déanann léarscáil formáide DWYT athbhreithniú ar dhintiúir chumasaithe tacaíochta do hóstach API. Taispeánann sí pointe deiridh tionónta sannta ina dhiaidh sin agus ní chuireann sí cosán glao freastalaí amháin i bhfolach.

Url an tionóntahttps://dwyt.app

FíordheimhniúX-API-Key: pending_activation_…

Próifíl an chliaintDwytFlow

Leagan APIv1

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

Ar mhaithe le slándáil na dintiúr, tosaíonn DWYT le stóráil rúnda ar thaobh an fhreastalaí. Péireálann a mhapáil formáide sin le gan aon leabú i mbunán an chliaint agus críochnaíonn sé le gan aon logaí ná stórtha poiblí.

Réitigh nasc

Déanann léarscáil formáide DWYT athbhreithniú ar bhrath foinse don oibríocht Resolve. Taispeánann sé formáidí ó URL amháin a cuireadh isteach ina dhiaidh sin agus ní cheiltíonn sé aon aschur nach bhfuil ann.

POST/v1/resolveRaon feidhme: réiteach

Réimse	Cineál	Riachtanach	Cur Síos
`public_media`	URL HTTPS	Sea	Leathanach meán poiblí nó údaraithe le haghaidh anailíse.
`tenant`	sreang	Ainm	Fearann tionónta ceaptha. De ghnáth scartha.

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

Maidir le haitheantóir Formáide, tosaíonn DWYT leis an luach aischurtha gan athrú. Péireálann a mhapa formáide é sin le hinfhaighteacht in aghaidh an naisc agus críochnaíonn sé gan lipéad cáilíochta measta.

Cruthaigh agus lean post íoslódála

Le haghaidh cruthú poist, seiceálann DWYT ullmhúchán asincrónach roimh iarratas gairid HTTP. Déanann an mapa formáide seo soiléir freisin forghníomhú oibrithe teoranta.

POST/v1/jobsRaon feidhme: poist

Réimse	Cineál	Riachtanach	Cur Síos
`public_media`	URL HTTPS	Sea	An foinse normalaithe chéanna a cuireadh isteach le réiteach a fháil.
`rendition_key`	sreang	Sea	Aitheantas cruinn ón bhfreagra réitigh.
`tenant`	sreang	Ainm	Fearann tionónta ceaptha. De ghnáth scartha.

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 GlacthaSábháil flow_id.

2Stádas na pobalbhreitheGET /v1/jobs/{flow_id} leis an eochair chéanna.

3RéidhOscail an URL íoslódála sínithe.

Stádas	Brí	Gníomh cliaint
`queued`	Ligean isteach sa scuaine teorannaithe.	Poll arís le cúlú.
`extracting`	Meiteashonraí foinse nó bealach á n-athnuachan.	Lean ar aghaidh ag vótáil.
`processing`	Ag íoslódáil, ag athmhúnlú nó ag cumasc.	Dul chun cinn an fhreastalaí a thaispeáint.
`ready`	Tá íoslódáil shínithe ar fáil.	Seol an URL chuig an úsáideoir.
`failed`	Earráid struchtúrtha teirminéil.	Léigh `error_code`. Déan iarracht arís ach amháin nuair a mholtar.
`expired`	Baineadh aschur sealadach.	Cruthaigh post nua.

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

Tosaíonn pobalbhreith poist le fanacht tosaigh de shoicind amháin ar DWYT. Ansin cuireann an mapa formáide seo eascairt uasteorannaithe i láthair. Is é an fíric deiridh ná seachadadh sínithe sealadach.

Earráidí intuartha

Déileálann DWYT le conradh Earráide trí phacáiste neamh-2xx amháin a aithint ar dtús. Leanann sé le haitheantas iarratais tacaíochta agus coinníonn sé láimhseáil intuartha an chliaint i gcuimhne.

{
  "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	Brí tipiciúil	Gníomh
400	URL neamhbhailí, comhlacht nó formáid nach bhfuil ar fáil.	Ceartaigh an iarraidh. Réitigh arís do fhormáidí.
401	Eochair ar iarraidh, neamhbhailí, imithe in éag nó le scóip mícheart.	Seiceáil an dintiúr taobh freastalaí.
403	Dhiúltaigh an tionónta nó an beartas foinse an iarraidh.	Ná seachain an polasaí. Déan teagmháil leis an tacaíocht.
404	Post anaithnid nó as feidhm.	Cruthaigh post nua más cuí.
429	Iarratas nó teorainn gníomhach-phoist bainte amach.	Onóir `retry_after_seconds`.
503	Tá an cíos/acmhainn nó an sreabhadh suas go sealadach neamhghníomhach.	Déan iarracht arís le moill eispéireamach agus jitters.

Conradh oibríochta

Déanann DWYT athbhreithniú ar an gcomhtháthú sula roghnaíonn sé cuótaí a chosnaíonn an cliant físe agus na seirbhísí in aghaidh an tsrutha araon.

Bain úsáid as loighic iarratais idempotent agus ná cuir tús le poist dúblacha riamh don chliceáil úsáideora céanna.
Réitigh meiteashonraí taisce go gearr, ach i gcónaí córais íoslódála sínithe a chóireáil mar a bhfuil siad ag dul in éag.
Úsáid siarghabháil eispéireamach teoranta le jitters do 429, 503 agus earráidí inath-iarrtha.
Próiseáil ach meáin phoiblí nó meáin a bhfuil tú údaraithe chun rochtain a fháil orthu. Ní sheachnaítear DRM agus rialuithe rochtana.
Coinnigh IDanna iarratais agus IDanna jabanna i logs oibríochta príobháideacha. Ná logáil URLanna a cuireadh isteach gan ghá.

Déanann léarscáil formáide DWYT athbhreithniú ar ghníomhachtú roimh iniúchadh le haghaidh rochtain ar Schema. Taispeánann sé fíordheimhniú sannta ina dhiaidh sin agus ní cheileann sé cruthanna iarratais doiciméadaithe.

ROCHTAIN A BHFUIL OIBRIÚIRÍ AG LÉIRMHEAS

Gníomhachtaigh trí thacaíocht

Mínigh an feidhmchlár atá taobh thiar den iarratas, a mheas tráchta míosúil agus na seirbhísí físe a úsáidfidh sé. Déanann DWYT athbhreithniú ar na sonraí sin, sannann sé na ceadanna API riachtanacha agus ní choinníonn sé aon luach eochrach in-aisghabhála.

Iarr ar ghníomhachtú Tá eochracha scóip-tionónta, in-aisghairthe agus eisithe tríd an bhfoirm Teagmhála. Ní féidir le scripteanna gan ainm obair íoslódálaí a fhorghníomhú.