https://easyt.ioBuild բեռնումներ հետ EasyT
Այս EasyT հղումը իրականացման ուղեցույց է, այլ ոչ թե ակտիվ անանուն վերջնակետ. Արտադրության հասանելիությունը սկսվում է միայն այն բանից հետո, երբ աջակցությունը հաստատում է հաճախորդին և սահմանում սահմանափակումներ.
Արագ սկսել
API հյուրընկալողը սկսվում է աջակցությամբ ակտիվացված հավատարմագրերով EasyT- ի վրա. Այս ուղեցույցի ստուգումը այնուհետև ներկայացնում է նշանակված վարձակալի վերջնակետ. Վերջնական փաստը միայն սերվերի զանգի ուղին է:
X-API-Key: pending_activation_…EasytWorkspacev1# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"
curl -X POST https://easyt.io/v1/resolve \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'In EasyT, սերվերի կողմի գաղտնի պահեստավորումը առաջին տեղում է, երբ բացատրում է Credential safety. Այդ ուղեցույցի ստուգումը հետևում է ոչ մի հաճախորդի փաթեթի ներդրման և փակվում է ոչ մի հանրային գրառումների կամ պահեստների վրա.
Հղում լուծել
Resolve գործողությունը սկսվում է աղբյուրի հայտնաբերմամբ EasyT- ի վրա. Այս ուղեցույցի ստուգումը այնուհետև ներկայացնում է ձևաչափեր մեկ ներկայացված URL- ից. Վերջնական փաստը ոչ մի հորինել արտադրանք.
/v1/resolveՏարածություն: լուծել| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
input_url | HTTPS URL- ն | Այո | Հանրային կամ լիազորված լրատվամիջոցի էջը վերլուծելու համար. |
tenant | տող | Ոչ | Նշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։ |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}In EasyT, վերադարձված արժեքը անփոփոխ է գալիս առաջինը, երբ բացատրում է Ֆորմատի ճանաչող. Այդ ուղեկցվող ստուգումը հետևում է ըստ հղման հասանելիության և փակվում է ոչ մի գուշակված որակի պիտակի վրա.
Ստեղծել և հետևել ներբեռնման աշխատանքին
Ասինխրոն պատրաստումը սկզբնաղբյուրն է Աշխատանքային ստեղծման համար EasyT- ում.Այնուհետև ուղեկցվող ստուգումը ներկայացնում է կարճ HTTP խնդրանք և բացատրում է սահմանափակված աշխատողի կատարումը.
/v1/jobsՏարածք: աշխատանքներ| Դաշտ | Տիպ | Պահանջվող | նկարագրություն |
|---|---|---|---|
input_url | HTTPS URL- ն | Այո | Նույն նորմալացված աղբյուրը ներկայացրել է լուծելու համար. |
stream_choice | տող | Այո | Հստակ ID- ը լուծման պատասխանից. |
tenant | տող | Ոչ | Նշված վարձու տիրույթ.Սովորաբար բաց է թողնվում։ |
curl -X POST https://easyt.io/v1/jobs \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'workspace_job.GET /v1/jobs/{workspace_job} նույն բանալիով։| Կարգ | նշանակություն | Հաճախորդի գործողություն |
|---|---|---|
queued | Ընդունվել է սահմանափակված հերթում. | Հարցում կրկին հետքաշմամբ. |
extracting | Վերանորոգվում են աղբյուրի մետա տվյալները կամ երթուղին։ | Շարունակել քվեարկությունը։ |
processing | Բեռնում, ռեմուքսավորում կամ միավորում. | Ցույց տալ սերվերի առաջընթացը. |
ready | ստորագրված ներբեռնումը հասանելի է. | Ուղարկեք URL- ը օգտվողին. |
failed | Տերմինալ կառուցվածքային սխալ. | Կարդալ error_code. Կրկնեք փորձը միայն խորհուրդ տալուց հետո: |
expired | Ժամանակավոր արտադրությունը վերացվեց։ | Ստեղծել նոր աշխատանք. |
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"Աշխատանքային հարցման համար EasyT սկսվում է մեկ վայրկյան սկզբնական սպասմամբ. Նրա ուղեկցվող ստուգումը զույգ է, որ կաֆե backoff- ի հետ և ավարտվում է ժամանակավոր ստորագրված առաքմամբ.
Նախատեսելի սխալներ
EasyT- ը Error պայմանագիրը հեշտ է սկանավորել. Էջը սկսվում է մեկ ոչ 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 | հերթափոխ / հզորություն կամ վերին հոսք ժամանակավորապես հասանելի չէ. | Կրկին փորձեք էքսպոնենցիալ հետադարձով և ջիտերով. |
Գործողության պայմանագիր
EasyT ընտրում է գործողության նպաստը վերանայման ընթացքում, հավասարակշռելով դիմումի կարիքները մատակարարի առողջության հետ:
- Օգտագործեք idempotent դիմումի տրամաբանությունը եւ երբեք չսկսեք կրկնօրինակ աշխատանքներ նույն օգտվողի սեղմում.
- Քեշը լուծում է մետա տվյալները կարճ, բայց միշտ վերաբերվում է ստորագրված ներբեռնման URL- ներին որպես ժամկետանց.
- Օգտագործեք սահմանափակված էքսպոնենցիալ հետադարձը jitter- ի հետ համար
429,503և կրկնակի փորձարկվող սխալներ։ - Աշխատել միայն հանրային լրատվամիջոցների կամ լրատվամիջոցների, որոնք դուք իրավունք ունեք մուտք գործել. DRM- ը և մուտք գործելու վերահսկողությունը չեն շրջանցվում.
- Պահպանեք խնդրանքի ID- ները և աշխատանքի ID- ները մասնավոր գործողությունների գրառումներում. Մի գրանցեք ներկայացված URL- ները անտեղի.
Սխեման մուտք սկսվում է ակտիվացումից առաջ ուսումնասիրության վրա EasyT. Այս ուղեկցվող ստուգումը այնուհետև ներկայացնում է նշանակված հավատարմագրումը. Վերջնական փաստը փաստաթղթավորված է խնդրանքի ձևերով.
Ակտիվացնել աջակցության միջոցով
Ներառեք հաճախորդի նպատակը, սպասվող ամսական աշխատանքային ծանրաբեռնվածությունը և խնդրվող ցանցերը ակտիվացման նկատառումով EasyT- ը կարող է այնուհետև ճիշտ ընտրել լուծել և աշխատանքային շրջանակներ, նախքան մեկ տեսանկյունից գաղտնի արտադրելը.
Ակտիվացման խնդրանք Կախարդական բանալիները վարձու ոլորտ են, վերացական և տրվում են Կապի ձևի միջոցով Անանուն սցենարները չեն կարող իրականացնել ներբեռնողի աշխատանքը.