Hakikisho tu — uanzishaji unahitajika

Unda vipakuliwa kwa kutumia DWTT

DWTT inachapisha muhtasari huu wa ujumuishaji kwa ajili ya kupanga, sio utekelezaji usiojulikana. Msaada lazima uidhinishe mtiririko wa kazi wa clip kabla ya kutoa ufunguo wa scoped na posho yake ya trafiki.

DwttToolkitJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

DWTT inafanya mwenyeji wa API iwe rahisi kuchunguza. Ukurasa huanza na vitambulisho vilivyoamilishwa na msaada, huhamia kwenye mwisho wa mpangaji aliyeteuliwa, na inaeleza wazi njia ya wito wa seva tu.

URL ya mpangajihttps://dwtt.app

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaDwttToolkit

Toleo la APIv1

# Available only after support activation
export DWTT_TOOL_TOKEN="issued-after-review"

curl -X POST https://dwtt.app/v1/resolve \
  -H "X-API-Key: $DWTT_TOOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID"}'

DWTT inakaribia Usalama wa vitambulisho kupitia uhifadhi wa siri wa upande wa seva, kisha hakuna uingizaji wa kifurushi cha mteja. Mtiririko wa kazi ulioboreshwa hauhifadhi magogo ya umma au maghala wazi.

Tatua kiungo

DWTT inafanya operesheni ya Resolve iwe rahisi kuchunguza. Ukurasa huanza na kugundua chanzo, huhamia kwa muundo kutoka kwa URL moja iliyowasilishwa, na inaeleza wazi hakuna matokeo yaliyozuliwa.

Chapisho/v1/resolveUpeo: suluhisha

Uga	Aina	Inahitajika	Maelezo
`source_link`	URL ya HTTPS	Ndiyo	Ukurasa wa vyombo vya habari wa umma au ulioidhinishwa kuchambuliwa.
`tenant`	string	Hapana	Kikoa cha mpangaji kilichowekwa. Kawaida huachwa.

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

DWTT inakaribia Kitambulisho cha muundo kupitia thamani iliyorudishwa bila kubadilika, kisha upatikanaji wa kiungo kwa kila kiungo. Mtiririko wa kazi ulioboreshwa unahifadhi hakuna lebo ya ubora wa kudhaniwa wazi.

Unda na fuata kazi ya upakuaji

Katika DWTT, maandalizi ya asynchronous huja kwanza wakati wa kuelezea Uundaji wa Kazi. Hiyo workflow ya streamlined ifuatayo na ombi fupi la HTTP na kufunga juu ya utekelezaji wa mfanyakazi aliyefungwa.

Chapisho/v1/jobsWigo: kazi

Uga	Aina	Inahitajika	Maelezo
`source_link`	URL ya HTTPS	Ndiyo	Chanzo kilekile kilichosanifishwa kilichowasilishwa ili kutatua.
`format_ref`	string	Ndiyo	Kitambulisho kamili kutoka kwenye jibu la resolve.
`tenant`	string	Hapana	Kikoa cha mpangaji kilichowekwa. Kawaida huachwa.

curl -X POST https://dwtt.app/v1/jobs \
  -H "X-API-Key: $DWTT_TOOL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"source_link":"https://www.youtube.com/watch?v=VIDEO_ID","format_ref":"18"}'

1202 ImekubaliwaHifadhi task_ref.

2Hali ya kuraGET /v1/jobs/{task_ref} na ufunguo uleule.

3TayariFungua URL ya upakuaji iliyosainiwa.

Hali	Maana	Kitendo cha mteja
`queued`	Amekubaliwa kwenye foleni yenye kikomo.	Jaribu tena baadaye kwa kutumia kusubiri kwa muda unaoongezeka.
`extracting`	Kusasisha metadata ya chanzo au njia.	Endelea kupiga kura.
`processing`	Kupakua, kuunganishia upya au kuunganisha.	Onyesha maendeleo ya seva.
`ready`	Upakuaji uliosainiwa unapatikana.	Tuma URL kwa mtumiaji.
`failed`	Hitilafu iliyopangwa ya terminal.	Soma `error_code`. Jaribu tena tu unaposhauriwa.
`expired`	Matokeo ya muda yameondolewa.	Unda kazi mpya.

curl https://dwtt.app/v1/jobs/TASK_REF \
  -H "X-API-Key: $DWTT_TOOL_TOKEN"

Ili kuelezea kupiga kura kwa Job, DWTT hutenganisha kusubiri kwa mwanzo wa sekunde moja kutoka kwa backoff iliyofungwa. Mtiririko wa kazi ulioboreshwa hutoa utoaji wa muda uliosainiwa mahali pake mwenyewe.

Makosa yanayotabirika

Sura moja isiyo ya 2xx ni mwanzo wa Mkataba wa Hitilafu kwenye DWTT. Mtiririko wa kazi ulioboreshwa kisha unawasilisha kitambulisho cha ombi la msaada na unaelezea ushughulikiaji wa mteja unaoweza kutabirika.

{
  "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	Maana ya kawaida	Kitendo
400	URL batili, mwili au umbizo halipatikani.	Rekebisha ombi. Tatua tena kwa ajili ya fomati.
401	Ufunguo haupo, si sahihi, muda wake umeisha, au una wigo usio sahihi.	Angalia kitambulisho cha upande wa seva.
403	Sera ya mpangaji au chanzo imekataa ombi.	Usipite sera. Wasiliana na usaidizi.
404	Kazi isiyojulikana au iliyokwisha muda wake.	Unda kazi mpya ikiwa inafaa.
429	Kikomo cha ombi au kazi inayotumika kimefikiwa.	Heshima `retry_after_seconds`.
503	Foleni/uwezo au huduma ya juu kwa muda haipatikani.	Jaribu tena kwa kutumia ucheleweshaji unaoongezeka kwa kasi na jitter.

Mkataba wa uendeshaji

DWTT inaweka marupurupu ya trafiki wakati wa uanzishaji ili ujumuishaji wa clip na mitandao ya chanzo haijajaa.

Tumia mantiki ya programu inayotumika mara moja bila kuathiri matokeo na usianzishe kamwe kazi rudufu kwa kubofya kwa mtumiaji mmoja.
Hifadhi metadata ya kutatua kashe kwa muda mfupi, lakini daima chukulia URL za upakuaji zilizosainiwa kuwa zina muda wa kuisha.
Tumia kurudi nyuma kwa kasi yenye mipaka na mtikisiko kwa 429, 503 na makosa yanayoweza kujaribiwa tena.
Chakata tu maudhui ya umma au maudhui ambayo umeidhinishwa kuyafikia. DRM na vidhibiti vya ufikiaji havipitiwi.
Hifadhi vitambulisho vya ombi na vitambulisho vya kazi katika kumbukumbu za uendeshaji za faragha. Usirekodi URL zilizowasilishwa bila ulazima.

DWTT hufanya ufikiaji wa Schema rahisi kuchunguza. Ukurasa huanza na uanzishaji kabla ya utafiti, huhamia kwa uthibitishaji uliopewa, na inaeleza wazi maumbo ya ombi yaliyoandikwa.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Tuma DWTT ujumuishaji uliokusudiwa, huenda kiasi cha maombi na mitandao lengwa. Taja kama mteja anahitaji utatuzi, uundaji wa kazi au vyote viwili ili ufunguo uliopangwa uweze kuidhinishwa na kuonyeshwa mara moja.

Omba uanzishaji Vifunguo vinahusiana na mpangaji, vinaweza kufutwa na hutolewa kupitia fomu ya Mawasiliano. Hati zisizojulikana haziwezi kutekeleza kazi ya kipakua.