https://ytsave.appBuild բեռնումներ հետ YTSave
Լուծեք հանրային լրատվամիջոցի URL- ը, ընտրեք ճշգրիտ ձևաչափ, ստեղծեք ասինխրոն աշխատանք և հանձնեք ստորագրված արդյունքը ձեր օգտվողին. Նույն սահմանափակ արտադրական խողովակաշարը ուժ է տալիս YTSave կայքին.
Արագ սկսել
YTSave կառավարում է API հյուրը՝ նախապես ճանաչելով աջակցված ակտիվացված հավատարմագրերը։ Այն հետևում է նշանակված վարձակալության վերջնակետին և պահպանում է միայն սերվերի կանչի ուղին տեսադաշտում։
X-API-Key: ys_live_…YTSaveClientv1# 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-ը սերվերի կողմի գաղտնի պահեստավորումը առանձնացնում է հաճախորդի փաթեթի ներմուծումից։ Ապացույցների գրանցամատյանը հանրային գրառումներ կամ պահոցներ իր տեղը չի տալիս։
Հղում լուծել
YTSave-ը լուծման գործողությունը իրականացնում է սկզբում աղբյուրի հայտնաբերման միջոցով։ Այն հետևում է մեկ ներկայացված URL-ից ձևաչափերին և չի պահպանում գյուտարար ելքեր դիտման մեջ։
/v1/resolveՏարածություն: լուծել| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
url | HTTPS URL- ն | Այո | Հանրային կամ լիազորված լրատվամիջոցի էջը վերլուծելու համար. |
tenant | տող | Ոչ | Նշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Ֆորմատի նույնացուցիչը բացատրելու համար, YTSave-ը վերադարձված արժեքը անփոփոխ առանձնացնում է յուրաքանչյուր հղման հասանելիությունից։ Ապացույցների գրանցամատյանը որակավորման գուշակված պիտակին իր տեղը չի տալիս։
Ստեղծել և հետևել ներբեռնման աշխատանքին
Աշխատանքի ստեղծման համար, YTSave-ը սկսվում է ասինխրոն պատրաստմամբ։ Նրա ապացույցների գրանցումը զուգորդվում է կարճ HTTP հարցման հետ և ավարտվում է սահմանափակված աշխատողի կատարմամբ։
/v1/jobsՏարածք: աշխատանքներ| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
url | HTTPS 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"}'job_id.GET /v1/jobs/{job_id} նույն բանալիով։| Կարգ | նշանակություն | Հաճախորդի գործողություն |
|---|---|---|
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-ը հեշտացնում է Աշխատանքի հարցումը սկանավորելու համար։ Էջը սկսվում է մեկ վայրկյան սկզբնական սպասումով, անցնում է սահմանափակ հետքայլի, և հստակ նշում է ժամանակավոր ստորագրված առաքումը։
Նախատեսելի սխալներ
Սխալի պայմանագրի համար, 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 | հերթափոխ / հզորություն կամ վերին հոսք ժամանակավորապես հասանելի չէ. | Կրկին փորձեք էքսպոնենցիալ հետադարձով և ջիտերով. |
Գործողության պայմանագիր
YTSave յուրաքանչյուր հաստատման հետ տրամադրում է գործառնական քվոտա՝ API սպառողին և վերին մակարդակի մեդիա ծառայություններին պաշտպանելու համար։
- Օգտագործեք idempotent դիմումի տրամաբանությունը եւ երբեք չսկսեք կրկնօրինակ աշխատանքներ նույն օգտվողի սեղմում.
- Քեշը լուծում է մետա տվյալները կարճ, բայց միշտ վերաբերվում է ստորագրված ներբեռնման URL- ներին որպես ժամկետանց.
- Օգտագործեք սահմանափակված էքսպոնենցիալ հետադարձը jitter- ի հետ համար
429,503և կրկնակի փորձարկվող սխալներ։ - Աշխատել միայն հանրային լրատվամիջոցների կամ լրատվամիջոցների, որոնք դուք իրավունք ունեք մուտք գործել.DRM- ը և մուտք գործելու վերահսկողությունը չեն շրջանցվում.
- Պահպանեք խնդրանքի ID- ները և աշխատանքի ID- ները մասնավոր գործողությունների գրառումներում. Մի գրանցեք ներկայացված URL- ները անտեղի.
YTSave-ը կառավարում է Schema մուտքը՝ նախանշելով ակտիվացումը նախքան ուսումնասիրությունը։ Այն հետևում է նշանակված վավերացմանը և պահպանում է փաստաթղթավորված հարցման ձևերը դիտման մեջ։ OpenAPI-ի հղում
Պահանջեք ձեր API բանալի
Փաստաթղթավորեք API-ի սպառողին, նրա ամսական հարցումների գնահատականը և աջակցվող հարթակի պահանջները։ YTSave-ը վերանայում է՝ արդյոք լուծումը, աշխատանքի ներկայացումը կամ երկուսն էլ արդարացված են, նախքան մեկ անգամ տեսանելի բանալին տրամադրելը։
Պահանջեք API մուտք Կախարդական բանալիները վարձու ոլորտ են, վերացական և տրվում են Կապի ձևի միջոցով Անանուն սցենարները չեն կարող իրականացնել ներբեռնողի աշխատանքը.