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

Изградите преузимања саEasyF

EasyF prikazuje interfejs unapred kako bi programeri mogli da procene svoj rad. Potrebna je još podrška za pregled pre nego što postoji aktivni ključ i granica korišćenja.

EasyfClientЈСОН преко ХТТПС-аАсинхрони пословиОбимне акредитиве

Брзи почетак

Da bi objasnio API host, EasyF odvaja akreditive aktivirane podrškom od dodeljene krajnje tačke zakupca. Radni tok u običnom jeziku daje putanji poziva samo za server sopstveno mesto.

УРЛ закупцаhttps://easyf.app

АутентификацијаX-API-Key: pending_activation_…

Профил клијентаEasyfClient

Верзија АПИ-јаv1

# 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"}'

Bezbednost akreditiva počinje sa skladištenjem tajni na strani servera na EasyF. Sledeći prikaz ne uključuje ugrađivanje klijentskog paketa. Stranica ne čuva javne dnevnike ili vidljive repozitorijume.

Решите везу

Da objasnimo operaciju Resolve, EasyF odvaja detekciju izvora od formata sa jedne poslata URL adrese. Radni tok na običnom jeziku ne daje izmišljenim izlazima svoje mesto.

ПОШТА/v1/resolveОпсег: решити

Поље	Тип	Обавезно	Опис
`asset_url`	ХТТПС УРЛ	Да	Јавна или овлашћена медијска страница за анализу.
`tenant`	низ	Не.	Додељени домен закупца.Обично се изоставља.

{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Идентификатор формата почиње са враћеном вредношћу непромењеном наEasyF. Следећи приказ покрива доступност по вези. Страница не чува никакву нагађану ознаку квалитета видљиву.

Креирајте и пратите посао за преузимање

EasyF predstavlja tri praktične tačke za kreiranje zadatka. Prvo dolazi asinhrona priprema. Radni tok u običnom jeziku zatim pokriva kratak HTTP zahtev. Njegova poslednja tačka je ograničeno izvršavanje radnika.

ПОШТА/v1/jobsОбим: послови

Поље	Тип	Обавезно	Опис
`asset_url`	ХТТПС УРЛ	Да	Исти нормализовани извор поднео да се реши.
`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 pristupa anketiranju poslova kroz početno čekanje od jedne sekunde, zatim ograničeno odlaganje. Radni tok jednostavnim jezikom jasno prikazuje privremenu potpisanu isporuku.

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

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": "…"
}

ХТТП	Типично значење	Радња
400	Неважећи УРЛ, тело или недоступан формат.	Исправити захтев.Решите поново за формате.
401	Недостатак, неважећи, истекао или погрешан кључ.	Проверите акредитиве на страни сервера.
403	Станар или извор политика одбио захтев.	Немојте заобићи политику.Контактирајте подршку.
404	Непознати или истекли посао.	Креирајте нови посао ако је то прикладно.
429	Досегнута граница захтева или активних задатака.	Почасни `retry_after_seconds`.
503	Ред / капацитет или узводно привремено недоступан.	Поново покушајте са експоненцијалним бекоффом и џитером.

Оперативни уговор

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

Користите идемпотентну логику апликације и никада не покрените дупликат послова за исти кориснички клик.
Кеш решава метаподатке кратко, али увек третира потписане УРЛ-ове за преузимање као истекао.
Користите ограничено експоненцијално бекофф са џитером за 429, 503 и поновљиве грешке.
Обрађивати само јавне медије или медије којима сте овлашћени да приступите. DRM и контроле приступа нису заобиђени.
Чувајте идентификаторе захтева и идентификаторе послова у приватним оперативним дневницима.Немојте непотребно евидентирати поднесене УРЛ-ове.

Da bi objasnio pristup šemi, EasyF odvaja aktivaciju pre istraživanja od dodeljene autentifikacije. Radni tok u običnom jeziku daje dokumentovanim oblicima zahteva sopstveno mesto.

ПРИСТАП КОЈИ ПРЕИЗИМА ОПЕРАТОР

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

Recite EasyF šta pravite, koliko često će pozivati API i koji provajderi su bitni. Pregled odlučuje dozvoljene operacije, zatim otkriva akreditiv jednom dok čuva samo njegov sigurni digest.

Захтев за активацију Кључеви су обухваћени закупцем, опозиви и издају се кроз формулар за контакт.Анонимне скрипте не могу извршити рад преузимача.