ԱՐՏԱԴՐՈՒԹՅՈՒՆ REST API · v1

Build բեռնումներ հետ YTSave

Լուծեք հանրային լրատվամիջոցի URL- ը, ընտրեք ճշգրիտ ձևաչափ, ստեղծեք ասինխրոն աշխատանք և հանձնեք ստորագրված արդյունքը ձեր օգտվողին. Նույն սահմանափակ արտադրական խողովակաշարը ուժ է տալիս YTSave կայքին.

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

Արագ սկսել

YTSave կառավարում է API հյուրը՝ նախապես ճանաչելով աջակցված ակտիվացված հավատարմագրերը։ Այն հետևում է նշանակված վարձակալության վերջնակետին և պահպանում է միայն սերվերի կանչի ուղին տեսադաշտում։

Վարձակալի URLhttps://ytsave.app
ԱհազանգX-API-Key: ys_live_…
Հաճախորդի պրոֆիլYTSaveClient
API տարբերակv1
# Available only after support activation
export YTSAVE_API_KEY="issued-after-review"

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

Վավերագրի անվտանգության բացատրության համար, YTSave-ը սերվերի կողմի գաղտնի պահեստավորումը առանձնացնում է հաճախորդի փաթեթի ներմուծումից։ Ապացույցների գրանցամատյանը հանրային գրառումներ կամ պահոցներ իր տեղը չի տալիս։

02

Հղում լուծել

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

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

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

03

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

Աշխատանքի ստեղծման համար, YTSave-ը սկսվում է ասինխրոն պատրաստմամբ։ Նրա ապացույցների գրանցումը զուգորդվում է կարճ HTTP հարցման հետ և ավարտվում է սահմանափակված աշխատողի կատարմամբ։

ԱՌԱՋ/v1/jobsՏարածք: աշխատանքներ
ԴաշտՏիպՊահանջվողնկարագրություն
urlHTTPS URL- նԱյոՆույն նորմալացված աղբյուրը ներկայացրել է լուծելու համար.
format_idտողԱյոՀստակ ID- ը լուծման պատասխանից.
tenantտողՈչՆշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։
curl -X POST https://ytsave.app/v1/jobs \
  -H "X-API-Key: $YTSAVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.youtube.com/watch?v=VIDEO_ID","format_id":"18"}'
1202 Ընդունված էՊահպանել job_id.
2Հարցման վիճակGET /v1/jobs/{job_id} նույն բանալիով։
3ՊատրաստԲացեք ստորագրված ներբեռնման URL- ը.
ԿարգնշանակությունՀաճախորդի գործողություն
queuedԸնդունվել է սահմանափակված հերթում.Հարցում կրկին հետքաշմամբ.
extractingՎերանորոգվում են աղբյուրի մետա տվյալները կամ երթուղին։Շարունակել քվեարկությունը։
processingԲեռնում, ռեմուքսավորում կամ միավորում.Ցույց տալ սերվերի առաջընթացը.
readyստորագրված ներբեռնումը հասանելի է.Ուղարկեք URL- ը օգտվողին.
failedՏերմինալ կառուցվածքային սխալ.Կարդալ error_code. Կրկնեք փորձը միայն խորհուրդ տալուց հետո:
expiredԺամանակավոր արտադրությունը վերացվեց։Ստեղծել նոր աշխատանք.
curl https://ytsave.app/v1/jobs/JOB_ID \
  -H "X-API-Key: $YTSAVE_API_KEY"

YTSave-ը հեշտացնում է Աշխատանքի հարցումը սկանավորելու համար։ Էջը սկսվում է մեկ վայրկյան սկզբնական սպասումով, անցնում է սահմանափակ հետքայլի, և հստակ նշում է ժամանակավոր ստորագրված առաքումը։

04

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

Սխալի պայմանագրի համար, YTSave-ը ստուգում է մեկ ոչ 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

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

YTSave յուրաքանչյուր հաստատման հետ տրամադրում է գործառնական քվոտա՝ API սպառողին և վերին մակարդակի մեդիա ծառայություններին պաշտպանելու համար։

YTSave-ը կառավարում է Schema մուտքը՝ նախանշելով ակտիվացումը նախքան ուսումնասիրությունը։ Այն հետևում է նշանակված վավերացմանը և պահպանում է փաստաթղթավորված հարցման ձևերը դիտման մեջ։ OpenAPI-ի հղում

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

Պահանջեք ձեր API բանալի

Փաստաթղթավորեք API-ի սպառողին, նրա ամսական հարցումների գնահատականը և աջակցվող հարթակի պահանջները։ YTSave-ը վերանայում է՝ արդյոք լուծումը, աշխատանքի ներկայացումը կամ երկուսն էլ արդարացված են, նախքան մեկ անգամ տեսանելի բանալին տրամադրելը։

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