https://easyt.ioИзграждане на изтегляния с EasyT
Този справочник EasyT е ръководство за внедряване, а не активна анонимна крайна точка. Достъпът в продукция започва само след одобрение на клиента от поддръжката и задаване на ограничения.
EasytWorkspaceJSON през HTTPSАсинхронни работни местаОбхватни идентификационни данни
01
Бърз старт
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"}'В EasyT съхранението на тайни от страна на сървъра е на първо място при обяснението на безопасността на удостоверенията. Тази насочена проверка следва без вграждане на клиентски пакет и завършва без публични дневници или хранилища.
02
Разрешаване на връзка
Операцията по разрешаване започва с откриване на източник на EasyT. Тази ръководена проверка след това представя формати от един подаден URL. Последният факт е, че няма измислени изходни данни.
ПОС
/v1/resolveОбхват: решаване| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
input_url | HTTPS адрес | Да | Публична или упълномощена медийна страница, която да анализира. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}В EasyT, върнатата непроменена стойност идва първа при обяснението на Идентификатор на формат. Тази насочена проверка следва с наличност на връзка и завършва без предположена етикет за качество.
03
Създаване и проследяване на задача за изтегляне
Асинхронната подготовка е отправната точка за създаване на задача на EasyT. След това ръководена проверка представя кратка HTTP заявка и обяснява изпълнението на ограничен работник.
ПОС
/v1/jobsОбхват: работни места| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
input_url | HTTPS адрес | Да | Същият нормализиран източник, подаден за разрешаване. |
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 започва с едносекундно първоначално изчакване. Неговата насочена проверка комбинира това с ограничено отлагане и завършва с временно подписана доставка.
04
Предсказуеми грешки
EasyT прави договора за грешки лесен за сканиране. Страницата започва с един плик, различен от 2xx, преминава към идентификатор на заявка за поддръжка и ясно посочва предвидимото обслужване на клиента.
{
"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": "…"
}| HTTP | Типично значение | Действие |
|---|---|---|
| 400 | Невалиден адрес, тяло или недостъпен формат. | Коригирайте заявката. Решете отново за формати. |
| 401 | Липсва, невалиден, изтекъл или с грешен обхват ключ. | Проверете идентификационните данни от страна на сървъра. |
| 403 | Наемател или източник политика отхвърли искането. | Не заобикаляйте правилата. Свържете се с поддръжката. |
| 404 | Неизвестна или изтекла работа. | Създайте нова работа, ако е подходящо. |
| 429 | Достигане на ограничението за заявки или активни задачи. | Чест. retry_after_seconds. |
| 503 | Опашка/капацитет или нагоре по веригата временно недостъпни. | Опитайте отново с експоненциално отстъпление и трептене. |
05
Договор за експлоатация
EasyT избира оперативен лимит по време на преглед, балансирайки нуждите на приложението със здравето на доставчика.
- Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
- Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
- Използвайте ограничен експоненциален отстъп с трептене за
429,503и повторяеми грешки. - Обработвайте само публични медии или медии, до които имате разрешение за достъп.DRM и контролите за достъп не се заобикалят.
- Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.
Достъпът до схемата започва с активиране преди изследване на EasyT. Тази насочена проверка след това представя зададена автентикация. Последният факт е документиран във формите на заявката.
Активиране чрез поддръжка
Включете целта на клиента, очакваното месечно натоварване и заявените мрежи в бележката за активиране. След това EasyT може правилно да избере обхвата на разрешаване и задачи преди да създаде едноизгледна тайна.
Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.