Hakikisho tu — uanzishaji unahitajika

Jenga upakuaji kwa downf.io

DownF huweka utekelezaji wa API ukiwa umezimwa hadi mwendeshaji akague kesi ya matumizi ya uoanifu. Mifano inaeleza mkataba uliopangwa, huku vitambulisho halisi na viwango vya matumizi vikija tu kupitia uanzishaji wa usaidizi.

DownfBridgeJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

DownF hupanga seva pangishi za API kuzunguka vitambulisho vilivyoamilishwa kwa usaidizi. Mwonekano wake wa uoanifu hulinganisha kituo cha mpangaji kilichogawiwa. Njia ya mwito ya upande wa seva pekee inasalia kuwa ukaguzi wa mwisho.

URL ya mpangajihttps://downf.io

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaDownfBridge

Toleo la APIv1

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

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

Usalama wa vitambulisho huanza na uhifadhi wa siri upande wa seva kwenye DownF. Mwonekano huu wa ulinganifu kisha hauonyeshi upachikaji wa kifurushi cha mteja. Ukweli wa mwisho ni kutokuwepo kwa kumbukumbu za wazi au hazina za umma.

Tatua kiungo

DownF hupanga operesheni ya Resolve kuzunguka ugunduzi wa chanzo. Mwonekano wake wa ulinganifu unalinganisha fomati kutoka URL moja iliyowasilishwa. Hakuna matokeo yaliyobuniwa hubaki ukaguzi wa mwisho.

Chapisho/v1/resolveUpeo: suluhisha

Uga	Aina	Inahitajika	Maelezo
`media_address`	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
}

Kitambulisho cha fomati kinaanza na thamani iliyorejeshwa bila kubadilishwa kwenye DownF. Kisha mwonekano huu wa uoanifu huonyesha upatikanaji kwa kila kiungo. Ukweli wa mwisho ni kwamba hakuna lebo ya ubora iliyokadiriwa.

Unda na fuata kazi ya upakuaji

Uundaji wa kazi huanza kwa maandalizi ya asynchroni kwenye DownF. Mwonekano unaofuata unahusu ombi fupi la HTTP. Ukurasa unaweka utekelezaji wa wafanyakazi wenye mipaka ukiwa unaonekana.

Chapisho/v1/jobsWigo: kazi

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

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

1202 ImekubaliwaHifadhi transfer_ref.

2Hali ya kuraGET /v1/jobs/{transfer_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://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

Mwonekano wa ulinganifu wa DownF unakagua muda wa kusubiri wa awali wa sekunde moja kwa uchunguzi wa kazi. Unaonyesha hatua inayofuata ya kusubiri kwa kuongezeka iliyowekwa kikomo na hauifichi uwasilishaji wa muda uliotiwa saini.

Makosa yanayotabirika

DownF inawasilisha hoja tatu za vitendo kwa Mkataba wa Hitilafu. Kwanza kunakuja bahasha moja isiyo ya 2xx. Mtazamo wa uoanifu kisha unashughulikia kitambulisho cha ombi la usaidizi. Hoja yake ya mwisho ni ushughulikiaji unaotabirika wa mteja.

{
  "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

DownF huweka kikomo cha ombi baada ya kukagua mteja anayelengwa, huku ikidumisha ukaguzi wake wa uoanifu na watoa huduma wa juu kuwa thabiti.

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.

DownF hupanga ufikiaji wa Schema kuzunguka uanzishaji kabla ya uchunguzi. Mwonekano wake wa uoanifu unalinganisha uthibitishaji uliopangiwa. Miundo ya maombi iliyoandikwa inabaki kuwa ukaguzi wa mwisho.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Eleza bidhaa, tabiri simu zake za kila mwezi na orodhesha majukwaa ambayo lazima ichambue. Usaidizi wa DownF utathibitisha scopes zinazohitajika kabla ya kutoa kitambulisho cha kuonekana mara moja ambacho nakala iliyohifadhiwa ni hash pekee.

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