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