Само за преглед — изисква се активиране

Изграждане на изтегляния с EasyF

EasyF показва интерфейса предварително, за да могат разработчиците да оценят своята работа. Все още е необходим преглед от поддръжката, преди да съществува активен ключ и граница на използване.

EasyfClientJSON през HTTPSАсинхронни работни местаОбхватни идентификационни данни
01

Бърз старт

За да обясни API хоста, EasyF отделя удостоверения, активирани от поддръжката, от определена крайна точка на наемател. Работният процес на прост език дава на пътя за повикване само от сървъра собствено място.

URL на клиентаhttps://easyf.app
УдостоверяванеX-API-Key: pending_activation_…
Профил на клиентаEasyfClient
Версия на APIv1
# 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. Следващият изглед обхваща липсата на вграждане на клиентски пакет. Страницата не поддържа видими публични дневници или хранилища.

02

Разрешаване на връзка

За да обясни операцията Resolve, EasyF отделя откриването на източника от формати от един подаден URL адрес. Работният процес на обикновен език не дава на измислените изходи собствено място.

ПОС/v1/resolveОбхват: решаване
ПолеТипЗадължителноОписание на продукта
asset_urlHTTPS адресДаПублична или упълномощена медийна страница, която да анализира.
tenantнизНе.Присвоен домейн на наемателя. Обикновено се пропуска.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Идентификаторът на формата започва с върнатата стойност без промяна на EasyF. Следващият изглед обхваща наличност на връзка. Страницата не показва видима етикет за предполагаемо качество.

03

Създаване и проследяване на задача за изтегляне

EasyF представя три практически точки за създаване на задачи. Първо идва асинхронната подготовка. След това работният процес на прост език обхваща кратка HTTP заявка. Неговата последна точка е ограничено изпълнение на работник.

ПОС/v1/jobsОбхват: работни места
ПолеТипЗадължителноОписание на продукта
asset_urlHTTPS адресДаСъщият нормализиран източник, подаден за разрешаване.
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"}'
1202 ПриетоЗапазване delivery_id.
2Статус на анкетатаGET /v1/jobs/{delivery_id} със същия ключ.
3ГотовОтворете подписания адрес за изтегляне.
СъстояниеЗначениеДействие на клиента
queuedДопуснат до ограничената опашка.Анкета отново с отстъпление.
extractingОбновяване на изходните метаданни или маршрут.Продължете да гласувате.
processingИзтегляне, ремиксиране или сливане.Показване на напредъка на сървъра.
readyПодписано изтегляне е налично.Изпратете адреса на потребителя.
failedТерминална структурирана грешка.Прочетете error_codeПовторете опита само когато ви бъде препоръчано.
expiredВременният изход беше премахнат.Създаване на нова работа.
curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF подхожда към изпращането на задания чрез първоначално изчакване от една секунда, след което се ограничава работният поток на обикновен език поддържа временно подписана доставка изрично.

04

Предсказуеми грешки

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Опашка/капацитет или нагоре по веригата временно недостъпни.Опитайте отново с експоненциално отстъпление и трептене.
05

Договор за експлоатация

EasyF съгласува практическите граници на употреба с всеки одобрен продукт, за да запази предвидим ръководен работен процес.

За да обясни достъпа до Схемата, EasyF отделя активирането преди изследването от присвоената автентикация. Работният процес на обикновен език дава на документираните форми на заявка собствено място.

ДОСТЪП, РЕВИЗИРАН ОТ ОПЕРАТОРА

Активиране чрез поддръжка

Кажете на EasyF какво изграждате, колко често ще извиква API и кои доставчици имат значение. Прегледът решава разрешените операции, след което разкрива идентификационни данни веднъж, като запазва само техния защитен хеш.

Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.