Hakikisho tu — uanzishaji unahitajika

Unda upakuzi kwa kutumia QuickDL

QuickDL huwaruhusu wasanidi programu kukagua modeli fupi ya ombi kabla ya kuwezeshwa. Usaidizi lazima uthibitishe bidhaa kabla ya ufunguo wa faragha na mgao kuanza kutumika.

QuickDlJobsJSON kupitia HTTPSKazi zisizolingana kwa wakatiStakabadhi zilizo na wigo

Anza haraka

Katika QuickDL, vitambulisho vilivyoamilishwa na usaidizi huja kwanza wakati wa kueleza hosti ya API. Huduma hiyo fupi ya matumizi hufuatiwa na kiolesura kilichowekewa mteja kilichogawiwa na hufungwa kwa njia ya mwito wa upande wa seva pekee.

URL ya mpangajihttps://quickdl.app

UthibitishajiX-API-Key: pending_activation_…

Wasifu wa mtejaQuickDlJobs

Toleo la APIv1

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

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

QuickDL hushughulikia usalama wa Kitambulisho cha Uthibitisho kwa kwanza kutambua hifadhi ya siri upande wa seva. Inafuata kwa kutokuwepo kwa kupachika kifurushi cha mteja na haina kumbukumbu za umma au hazina zilizo wazi.

Tatua kiungo

Katika QuickDL, utambuzi wa chanzo huja kwanza wakati wa kueleza operesheni ya Resolve. Huduma hiyo fupi hufuatiwa na fomati kutoka kwa URL moja iliyowasilishwa na huisha bila matokeo yaliyobuniwa.

Chapisho/v1/resolveUpeo: suluhisha

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

QuickDL hushughulikia Kitambulisho cha fomati kwa kwanza kutambua thamani iliyorejeshwa bila kubadilishwa. Kisha hufuata upatikanaji kwa kila kiungo na haihifadhi lebo ya ubora iliyokadiriwa kwa kuona.

Unda na fuata kazi ya upakuaji

Kifaa kifupi cha QuickDL kinakagua maandalizi yasiyolingana kwa uundaji wa Kazi. Kinaonyesha ombi fupi la HTTP linalofuata na hakifichi utekelezaji uliowekwa wa mfanyakazi.

Chapisho/v1/jobsWigo: kazi

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

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

1202 ImekubaliwaHifadhi quick_job.

2Hali ya kuraGET /v1/jobs/{quick_job} 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://quickdl.app/v1/jobs/QUICK_JOB \
  -H "X-API-Key: $QUICKDL_JOB_KEY"

QuickDL inatoa hoja tatu za vitendo kwa upigaji kura wa Job. Kwanza huja kusubiri kwa sekunde moja mwanzoni. Huduma hii ndogo kisha inashughulikia kurudi nyuma kwa kikomo. Hatua yake ya mwisho ni utoaji wa muda uliotiwa sahihi.

Makosa yanayotabirika

QuickDL inakaribia Mkataba wa Hitilafu kupitia bahasha moja isiyo ya 2xx, kisha kitambulisho cha ombi la msaada. Zana fupi huhifadhi ushughulikiaji wa mteja unaotabirika ukiwa wazi.

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

QuickDL hutoa mgao mfupi, mahususi kwa mteja, unaounga mkono ujumuishaji bila kuyumbisha huduma za chanzo.

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.

Katika QuickDL, uanzishaji kabla ya uchunguzi ndio wa kwanza wakati wa kueleza ufikiaji wa Schema. Huduma hiyo fupi hufuatiwa na uthibitishaji uliokabidhiwa na hufungwa kwa maumbo ya ombi yaliyoandikwa.

UFIKIAJI ULIOKAGULIWA NA MTOA HUDUMA

Washa kupitia usaidizi

Toa QuickDL pamoja na jina la muunganisho, ujazo wa kila mwezi unaotarajiwa na vyanzo vinavyohitajika. Bainisha shughuli ambazo seva itatekeleza ili idhini izalishe ufunguo wenye wigo mwembamba, wa mara moja.

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