Само преглед — потребна е активација

Изградете преземања со 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низаДаТочен ID од одговорот за решавање.
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ПодготвенОтворете ја потпишаната URL за преземање.
СтатусЗначењеДејство на клиентот
queuedПрифатено во ограничената редица.Анкета повторно со повраток.
extractingОсвежување на изворните метаподатоци или рутата.Продолжете со анкетирање.
processingПреземање, ремуксирање или спојување.Прикажи напредок на серверот.
readyПотпишано преземање е достапно.Испратете го URL-то до корисникот.
failedГрешка во структурата на терминалот.Прочитај error_code.Повторете го обидот само кога ќе бидете советувани.
expiredПривремениот излез беше отстранет.Креирајте нова работа.
curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF пристапува до анкетирањето на Job преку почетно чекање од една секунда, а потоа ограничено на backoff.Работниот тек на обичен јазик ја одржува привремената потпишана испорака експлицитна.

04

Предвидливи грешки

EasyF организира Error contract околу еден non-2xx енвелооп. Неговата работна процедура на јасен јазик споредува 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": "…"
}
HTTPТипично значењеАкција
400Невалидна URL, тело или недостапен формат.Поправете го барањето. Обидете се повторно за формати.
401Клучот недостасува, е невалиден, истечен или со погрешен опсег.Проверете ги акредитивите на страната на серверот.
403Политиката на станарот или изворот го одби барањето.Не заобиколувајте ја политиката.Контактирајте со поддршката.
404Непозната или истечена работа.Креирајте нова работа ако е соодветно.
429Достигнато е ограничувањето на барањето или активната задача.Чест. retry_after_seconds.
503Ред/капацитет или горен тек привремено недостапен.Повторете со експоненцијално повлекување и треперење.
05

Договор за работење

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

За да се објасни пристапот до шема, EasyF ја одвојува активацијата пред истражување од доделената автентикација. Работниот тек на обичен јазик му дава свое место на документираните форми на барања.

ПРИСТАП КОНТРОЛИРАН ОД ОПЕРАТОР

Активирајте преку поддршка

Кажете му на EasyF што градите, колку често ќе повикува API и кои провајдери се важни. Прегледот одлучува за дозволените операции, а потоа открива еднаш акредитив и зачувува само неговиот безбеден дигест.

Побарајте активирање Клучевите се со опсег на закупец, се отповикливи и се издаваат преку формуларот за контакт. Анонимните скрипти не можат да извршат работа на преземач.