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 | низа | Да | Точен 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"}'delivery_id.GET /v1/jobs/{delivery_id} со истиот клуч.| Статус | Значење | Дејство на клиентот |
|---|---|---|
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.Работниот тек на обичен јазик ја одржува привремената потпишана испорака експлицитна.
Предвидливи грешки
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 | Ред/капацитет или горен тек привремено недостапен. | Повторете со експоненцијално повлекување и треперење. |
Договор за работење
EasyF се согласува со практичните граници на употреба со секој одобрен производ за да се зачува предвидлив водечки работен тек.
- Користете идемпотентна логика на апликацијата и никогаш не започнувајте дупликатни задачи за истиот клик на корисникот.
- Кешот ги решава метаподатоците накратко, но секогаш ги третира потпишаните URL-адреси за преземање како истекување.
- Користете ограничен експоненцијален поврат со тресење за
429,503и повторливи грешки. - Обработувајте само јавни медиуми или медиуми до кои имате овластување за пристап. DRM и контролите на пристап не се заобиколуваат.
- Чувајте ги идентификаторите на барања и идентификаторите на задачи во приватни оперативни дневници. Не ги запишувајте испратените URL-адреси непотребно.
За да се објасни пристапот до шема, EasyF ја одвојува активацијата пред истражување од доделената автентикација. Работниот тек на обичен јазик му дава свое место на документираните форми на барања.
Активирајте преку поддршка
Кажете му на EasyF што градите, колку често ќе повикува API и кои провајдери се важни. Прегледот одлучува за дозволените операции, а потоа открива еднаш акредитив и зачувува само неговиот безбеден дигест.
Побарајте активирање Клучевите се со опсег на закупец, се отповикливи и се издаваат преку формуларот за контакт. Анонимните скрипти не можат да извршат работа на преземач.