https://quickdl.appՍտեղծեք ներբեռնումներ QuickDL-ով
QuickDL-ը թույլ է տալիս ծրագրավորողներին ստուգել կոմպակտ հարցման մոդելը ակտիվացման առաջ։ Աջակցությունը պետք է վավերացնի արտադրանքը, նախքան մասնավոր բանալին և քվոտան դառնան օգտագործելի։
Արագ սկսել
QuickDL-ում, API հոստը բացատրելու ժամանակ առաջինը նշվում են աջակցությամբ ակտիվացված հավատարմագրերը։ Այդ կոմպակտ օգտակարությունը հաջորդում է նշանակված վարձակալային վերջնակետին և ավարտվում է միայն սերվերի կանչի ուղով։
X-API-Key: pending_activation_…QuickDlJobsv1# 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-ը կառավարում է Հավաստագրերի անվտանգությունը՝ նախանշելով սերվերային կողմի գաղտնի պահեստը։ Այն չի ներառում հաճախորդի փաթեթ և չի պահպանում հանրային գրառումներ կամ պահոցներ տեսադաշտում։
Հղում լուծել
QuickDL-ում աղբյուրի հայտնաբերումը առաջինն է Resolve գործողությունը բացատրելու ժամանակ։ Այդ կոմպակտ օգտակարությունը հետևում է մեկ ներկայացված URL-ից ձևաչափերին և ավարտվում է առանց գյուտարար ելքային տվյալների։
/v1/resolveՏարածություն: լուծել| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
public_link | HTTPS URL- ն | Այո | Հանրային կամ լիազորված լրատվամիջոցի էջը վերլուծելու համար. |
tenant | տող | Ոչ | Նշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}QuickDL-ը մշակում է Ֆորմատի նույնականացուցիչը՝ նախապես նույնականացնելով վերադարձված արժեքը առանց փոփոխության։ Այն հետևում է յուրաքանչյուր հղման հասանելիությանը և չի պահում գուշակված որակի պիտակ տեսանելի։
Ստեղծել և հետևել ներբեռնման աշխատանքին
QuickDL-ի կոմպակտ օգտակարությունը վերանայում է Ասինխրոն պատրաստումը Աշխատանքի ստեղծման համար։ Այն ցույց է տալիս հաջորդ կարճ HTTP հարցումը և չի խանգարում սահմանափակված աշխատողի կատարմանը։
/v1/jobsՏարածք: աշխատանքներ| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
public_link | HTTPS URL- ն | Այո | Նույն նորմալացված աղբյուրը ներկայացրել է լուծելու համար. |
download_option | տող | Այո | Հստակ ID- ը լուծման պատասխանից. |
tenant | տող | Ոչ | Նշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։ |
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"}'quick_job.GET /v1/jobs/{quick_job} նույն բանալիով։| Կարգ | նշանակություն | Հաճախորդի գործողություն |
|---|---|---|
queued | Ընդունվել է սահմանափակված հերթում. | Հարցում կրկին հետքաշմամբ. |
extracting | Վերանորոգվում են աղբյուրի մետա տվյալները կամ երթուղին։ | Շարունակել քվեարկությունը։ |
processing | Բեռնում, ռեմուքսավորում կամ միավորում. | Ցույց տալ սերվերի առաջընթացը. |
ready | ստորագրված ներբեռնումը հասանելի է. | Ուղարկեք URL- ը օգտվողին. |
failed | Տերմինալ կառուցվածքային սխալ. | Կարդալ error_code. Կրկնեք փորձը միայն խորհուրդ տալուց հետո: |
expired | Ժամանակավոր արտադրությունը վերացվեց։ | Ստեղծել նոր աշխատանք. |
curl https://quickdl.app/v1/jobs/QUICK_JOB \
-H "X-API-Key: $QUICKDL_JOB_KEY"QuickDL ներկայացնում է երեք գործնական կետեր Job polling-ի համար։ Առաջինն է մեկ վայրկյան սկզբնական սպասում։ Կոմպակտ օգտակարությունը հետո ընդգրկում է սահմանափակված հետաձգումը։ Նրա վերջին կետը ժամանակավոր ստորագրված առաքումն է։
Նախատեսելի սխալներ
QuickDL մոտենում է Սխալի պայմանագրին մեկ ոչ 2xx ծածկույթի միջոցով, ապա աջակցման հարցման ID։ Կոմպակտ օգտակար ծրագիրը պահպանում է կանխատեսելի հաճախորդի մշակումը հստակ։
{
"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": "…"
}| Հատուկ պիտակներ | Տիպիկ նշանակություն | Գործողություն |
|---|---|---|
| 400 | Սխալ URL, մարմին կամ մատչելի ձևաչափ. | Կատարել խնդրանքը.Կարգավորել նորից ձևաչափերի համար. |
| 401 | Չկա, անվավեր է, ավարտվել է կամ սխալ շրջանակով բանալին. | Ստուգեք սերվերի կողմից հավատարմագրերը. |
| 403 | Վարձու կամ աղբյուր քաղաքականությունը մերժել է խնդրանքը. | Մի շրջանցեք քաղաքականությունը.Կապ հաստատեք աջակցության հետ. |
| 404 | Անհայտ կամ ժամկետանց աշխատանք. | Ըստ անհրաժեշտության ստեղծեք նոր աշխատանք։ |
| 429 | Ընդունվել է խնդրանք կամ ակտիվ-գործի սահմանափակում։ | Պարգև retry_after_seconds. |
| 503 | հերթափոխ / հզորություն կամ վերին հոսք ժամանակավորապես հասանելի չէ. | Կրկին փորձեք էքսպոնենցիալ հետադարձով և ջիտերով. |
Գործողության պայմանագիր
QuickDL- ը տրամադրում է կոմպակտ, հաճախորդի հատուկ կոտ, որը աջակցում է ինտեգրմանը առանց աղբյուրի ծառայությունների ապակայունացման:
- Օգտագործեք idempotent դիմումի տրամաբանությունը եւ երբեք չսկսեք կրկնօրինակ աշխատանքներ նույն օգտվողի սեղմում.
- Քեշը լուծում է մետա տվյալները կարճ, բայց միշտ վերաբերվում է ստորագրված ներբեռնման URL- ներին որպես ժամկետանց.
- Օգտագործեք սահմանափակված էքսպոնենցիալ հետադարձը jitter- ի հետ համար
429,503և կրկնակի փորձարկվող սխալներ։ - Աշխատել միայն հանրային լրատվամիջոցների կամ լրատվամիջոցների, որոնք դուք իրավունք ունեք մուտք գործել. DRM- ը և մուտք գործելու վերահսկողությունը չեն շրջանցվում.
- Պահպանեք խնդրանքի ID- ները և աշխատանքի ID- ները մասնավոր գործողությունների գրառումներում. Մի գրանցեք ներկայացված URL- ները անտեղի.
QuickDL-ում, Schema մուտքը բացատրելու ժամանակ առաջինը նշվում է ակտիվացումը նախքան ուսումնասիրությունը։ Այդ կոմպակտ օգտակարությունը հաջորդում է նշանակված վավերացմանը և ավարտվում է փաստաթղթավորված հարցման ձևերով։
Ակտիվացնել աջակցության միջոցով
Ներկայացրեք QuickDL-ին ինտեգրման անունը, սպասվող ամսական ծավալը և պահանջվող աղբյուրները։ Նշեք այն գործողությունները, որոնք սերվերը կկատարի, որպեսզի հաստատումը ապահովի նեղ շրջանակով, մեկանգամյա բանալին։
Ակտիվացման խնդրանք Կախարդական բանալիները վարձու ոլորտ են, վերացական և տրվում են Կապի ձևի միջոցով Անանուն սցենարները չեն կարող իրականացնել ներբեռնողի աշխատանքը.