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