https://easyf.appИзграждане на изтегляния с EasyF
EasyF показва интерфейса предварително, за да могат разработчиците да оценят своята работа. Все още е необходим преглед от поддръжката, преди да съществува активен ключ и граница на използване.
Бърз старт
За да обясни API хоста, EasyF отделя удостоверения, активирани от поддръжката, от определена крайна точка на наемател. Работният процес на прост език дава на пътя за повикване само от сървъра собствено място.
X-API-Key: pending_activation_…EasyfClientv1# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"
curl -X POST https://easyf.app/v1/resolve \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'Безопасността на удостоверенията започва със съхранение на тайни от страна на сървъра в EasyF. Следващият изглед обхваща липсата на вграждане на клиентски пакет. Страницата не поддържа видими публични дневници или хранилища.
Разрешаване на връзка
За да обясни операцията Resolve, EasyF отделя откриването на източника от формати от един подаден URL адрес. Работният процес на обикновен език не дава на измислените изходи собствено място.
/v1/resolveОбхват: решаване| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
asset_url | HTTPS адрес | Да | Публична или упълномощена медийна страница, която да анализира. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Идентификаторът на формата започва с върнатата стойност без промяна на EasyF. Следващият изглед обхваща наличност на връзка. Страницата не показва видима етикет за предполагаемо качество.
Създаване и проследяване на задача за изтегляне
EasyF представя три практически точки за създаване на задачи. Първо идва асинхронната подготовка. След това работният процес на прост език обхваща кратка HTTP заявка. Неговата последна точка е ограничено изпълнение на работник.
/v1/jobsОбхват: работни места| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
asset_url | HTTPS адрес | Да | Същият нормализиран източник, подаден за разрешаване. |
variant_code | низ | Да | Точен идентификатор от отговора за разрешаване. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
curl -X POST https://easyf.app/v1/jobs \
-H "X-API-Key: $EASYF_SERVICE_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'delivery_id.GET /v1/jobs/{delivery_id} със същия ключ.| Състояние | Значение | Действие на клиента |
|---|---|---|
queued | Допуснат до ограничената опашка. | Анкета отново с отстъпление. |
extracting | Обновяване на изходните метаданни или маршрут. | Продължете да гласувате. |
processing | Изтегляне, ремиксиране или сливане. | Показване на напредъка на сървъра. |
ready | Подписано изтегляне е налично. | Изпратете адреса на потребителя. |
failed | Терминална структурирана грешка. | Прочетете error_codeПовторете опита само когато ви бъде препоръчано. |
expired | Временният изход беше премахнат. | Създаване на нова работа. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF подхожда към изпращането на задания чрез първоначално изчакване от една секунда, след което се ограничава работният поток на обикновен език поддържа временно подписана доставка изрично.
Предсказуеми грешки
EasyF организира договор за грешки около един конверт, който не е 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 | Опашка/капацитет или нагоре по веригата временно недостъпни. | Опитайте отново с експоненциално отстъпление и трептене. |
Договор за експлоатация
EasyF съгласува практическите граници на употреба с всеки одобрен продукт, за да запази предвидим ръководен работен процес.
- Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
- Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
- Използвайте ограничен експоненциален отстъп с трептене за
429,503и повторяеми грешки. - Обработвайте само публични медии или медии, до които имате разрешение за достъп. DRM и контролите за достъп не се заобикалят.
- Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.
За да обясни достъпа до Схемата, EasyF отделя активирането преди изследването от присвоената автентикация. Работният процес на обикновен език дава на документираните форми на заявка собствено място.
Активиране чрез поддръжка
Кажете на EasyF какво изграждате, колко често ще извиква API и кои доставчици имат значение. Прегледът решава разрешените операции, след което разкрива идентификационни данни веднъж, като запазва само техния защитен хеш.
Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.