Միայն նախնական տեսություն — պահանջվում է ակտիվացում

Build բեռնումներ հետ downf.io

DownF- ը պահում է API- ի կատարումը անջատված, մինչև օպերատորը վերանայի համատեղելիության օգտագործման դեպքը. Օրինակները նկարագրում են նախատեսված պայմանագիրը, մինչդեռ իրական հավատարմագրերը և կվատները հասնում են միայն աջակցության ակտիվացման միջոցով.

DownfBridgeJSON- ը HTTPS- ի միջոցովԱսիմկրոն աշխատանքներՏարածված հավաստագրեր
01

Արագ սկսել

DownF-ը կազմակերպում է API հոստը աջակցությամբ ակտիվացված հավատարմագրերի շուրջ։ Նրա համապատասխանության դիտումը համեմատում է նշանակված վարձակալային վերջնակետը։ Միայն սերվերի կանչի ուղին մնում է վերջնական ստուգումը։

Վարձակալի URLhttps://downf.io
ԱհազանգX-API-Key: pending_activation_…
Հաճախորդի պրոֆիլDownfBridge
API տարբերակv1
# 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-ի սերվերային կողմի գաղտնի պահեստավորումից։ Այս համատեղելիության դիտումը ապա չի ներկայացնում հաճախորդի փաթեթի ներդրում։ Վերջնական փաստը՝ բաց հանրային գրառումներ կամ պահոցներ չկան։

02

Հղում լուծել

DownF-ը կազմակերպում է Resolve գործողությունը՝ կենտրոնանալով աղբյուրի հայտնաբերման վրա։ Նրա համատեղելիության դիտումը համեմատում է ձևաչափերը մեկ ներկայացված URL-ից։ Չհորինված ելքերը մնում են վերջնական ստուգումը։

ԱՌԱՋ/v1/resolveՏարածություն: լուծել
ԴաշտՏիպՊահանջվողնկարագրություն
media_addressHTTPS URL- նԱյոՀանրային կամ լիազորված լրատվամիջոցի էջը վերլուծելու համար.
tenantտողՈչՆշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Ֆորմատի նույնականացուցիչը սկսվում է վերադարձված արժեքով, որը չի փոխվում DownF-ում։ Այս համապատասխանության դիտումը ապա ներկայացնում է յուրաքանչյուր հղման հասանելիությունը։ Վերջնական փաստը՝ գուշակված որակի պիտակ չկա։

03

Ստեղծել և հետևել ներբեռնման աշխատանքին

Աշխատանքի ստեղծումը սկսվում է DownF-ում ասինխրոն պատրաստմամբ։ Հաջորդ դիտումը ընդգրկում է կարճ HTTP հարցում։ Էջը պահպանում է սահմանափակված աշխատողի կատարման տեսանելիությունը։

ԱՌԱՋ/v1/jobsՏարածք: աշխատանքներ
ԴաշտՏիպՊահանջվողնկարագրություն
media_addressHTTPS 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"}'
1202 Ընդունված էՊահպանել transfer_ref.
2Հարցման վիճակGET /v1/jobs/{transfer_ref} նույն բանալիով։
3ՊատրաստԲացեք ստորագրված ներբեռնման URL- ը.
ԿարգնշանակությունՀաճախորդի գործողություն
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-ի համապատասխանության դիտումը վերանայում է աշխատանքի հարցման մեկ վայրկյան նախնական սպասումը։ Այն ցույց է տալիս սահմանափակված հետքայլը և չի ծածկում ժամանակավոր ստորագրված առաքումը։

04

Նախատեսելի սխալներ

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հերթափոխ / հզորություն կամ վերին հոսք ժամանակավորապես հասանելի չէ.Կրկին փորձեք էքսպոնենցիալ հետադարձով և ջիտերով.
05

Գործողության պայմանագիր

DownF-ը սահմանում է խնդրի առավելագույն սահմանը՝ դիտարկելով նախատեսված հաճախորդին, պահպանելով նրա համապատասխանության ստուգումները և վերին մակարդակի մատակարարները կայուն։

DownF կազմակերպում է Schema մուտքը ակտիվացման շուրջ՝ նախքան ուսումնասիրությունը։ Նրա համատեղելիության դիտումը համեմատում է նշանակված վավերացմանը։ Փաստաթղթավորված հարցման ձևերը մնում են վերջնական ստուգումը։

ՕՊԵՐԱՏՈՐԻ ԿԱՐԳԱՎՈՐՎԱԾ ՄԱՍՆԱԳԻՏՈՒԹՅՈՒՆՆԵՐ

Ակտիվացնել աջակցության միջոցով

Նկարագրեք արտադրանքը, կանխատեսեք դրա ամսական զանգերը և նշեք այն հարթակները, որոնք պետք է վերլուծի։ DownF-ի աջակցությունը կհաստատի անհրաժեշտ ոլորտները նախքան մեկանգամյա տեսանելի հավատարմագրի տրամադրումը, որի պահված պատճենը միայն հեշ է։

Ակտիվացման խնդրանք Կախարդական բանալիները վարձու ոլորտ են, վերացական և տրվում են Կապի ձևի միջոցով Անանուն սցենարները չեն կարող իրականացնել ներբեռնողի աշխատանքը.