https://easyt.ioИзградите преузимања саEasyT
Ova referenca EasyT je vodič za implementaciju, a ne aktivna anonimna tačka pristupa. Pristup u produkciji počinje tek nakon što podrška odobri klijenta i dodeli ograničenja.
Брзи почетак
API host počinje sa akreditivima aktiviranim podrškom na EasyT. Ova vođena provera zatim prikazuje dodeljenu krajnju tačku zakupca. Konačni podatak je putanja poziva samo za server.
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"}'U EasyT, skladištenje tajni na serverskoj strani je prvo kada se objašnjava bezbednost akreditiva. Taj vođeni pregled prati se bez ugrađivanja klijentskog paketa i završava se bez javnih zapisa ili repozitorijuma.
Решите везу
Operacija rešavanja počinje detekcijom izvora na EasyT. Ova vođena provera zatim prikazuje formate sa jedne poslata URL adrese. Konačna činjenica je da nema izmišljenih izlaza.
/v1/resolveОпсег: решити| Поље | Тип | Обавезно | Опис |
|---|---|---|---|
input_url | ХТТПС УРЛ | Да | Јавна или овлашћена медијска страница за анализу. |
tenant | низ | Не. | Додељени домен закупца.Обично се изоставља. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}U EasyT, vraćena neizmenjena vrednost dolazi prva prilikom objašnjavanja identifikatora formata. Ta vođena provera zatim prati dostupnost po linku i završava se bez pretpostavljene oznake kvaliteta.
Креирајте и пратите посао за преузимање
Asinhrona priprema je polazna tačka za kreiranje posla na EasyT. Vođena provera zatim prikazuje kratak HTTP zahtev i objašnjava izvršavanje ograničenih radnika.
/v1/jobsОбим: послови| Поље | Тип | Обавезно | Опис |
|---|---|---|---|
input_url | ХТТПС УРЛ | Да | Исти нормализовани извор поднео да се реши. |
stream_choice | низ | Да | Тачан ИД из одговора на решавање. |
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 | Потписано преузимање је доступно. | Пошаљите УРЛ кориснику. |
failed | Терминал структурирана грешка. | Прочитај error_code.Поново покушајте само када се саветује. |
expired | Привремени излаз је уклоњен. | Креирајте нови посао. |
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"За анкетирање о Јову,EasyTпочиње са почетним чекањем од једне секунде.Његова вођена провера упарује то са ограниченим бекоффом и завршава се привременом потписаном испоруком.
Предвидљиве грешке
EasyT olakšava skeniranje Error ugovora. Stranica počinje sa jednim ne-2xx omotačem, prelazi na ID zahteva za podršku i jasno navodi predvidivo rukovanje klijentom.
{
"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 | Неважећи УРЛ, тело или недоступан формат. | Исправити захтев.Решите поново за формате. |
| 401 | Недостатак, неважећи, истекао или погрешан кључ. | Проверите акредитиве на страни сервера. |
| 403 | Станар или извор политика одбио захтев. | Немојте заобићи политику.Контактирајте подршку. |
| 404 | Непознати или истекли посао. | Креирајте нови посао ако је то прикладно. |
| 429 | Досегнута граница захтева или активних задатака. | Почасни retry_after_seconds. |
| 503 | Ред / капацитет или узводно привремено недоступан. | Поново покушајте са експоненцијалним бекоффом и џитером. |
Оперативни уговор
EasyTодабира оперативну накнаду током прегледа, балансирајући потребе апликације са здрављем провајдера.
- Користите идемпотентну логику апликације и никада не покрените дупликат послова за исти кориснички клик.
- Кеш решава метаподатке кратко, али увек третира потписане УРЛ-ове за преузимање као истекао.
- Користите ограничено експоненцијално бекофф са џитером за
429,503и поновљиве грешке. - Обрађивати само јавне медије или медије којима сте овлашћени да приступите. DRM и контроле приступа нису заобиђени.
- Чувајте идентификаторе захтева и идентификаторе послова у приватним оперативним дневницима.Немојте непотребно евидентирати поднесене УРЛ-ове.
Pristup šemi počinje aktivacijom pre istraživanja na EasyT. Ova vođena provera zatim prikazuje dodeljenu autentifikaciju. Konačni podatak je dokumentovani oblici zahteva.
Активирајте се кроз подршку
U belešku o aktivaciji uključite svrhu klijenta, očekivani mesečni obim posla i tražene mreže. EasyT tada može pravilno odabrati opseg rešavanja i zadatka pre nego što proizvede jedinstvenu tajnu.
Захтев за активацију Кључеви су обухваћени закупцем, опозиви и издају се кроз формулар за контакт.Анонимне скрипте не могу извршити рад преузимача.