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

Изградете преземања со FFast

FFast ја открива наменетата форма на API без да овозможи јавни повици. Операторот активира креденцијали и измерени квоти по прегледот на предложената интеграција.

FfastPipelineJSON преку HTTPSАсинхрони задачиОбемни акредитиви

Брз почеток

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

URL на закупецhttps://ffast.app

Проверка за автентичностX-API-Key: pending_activation_…

Профил на клиентFfastPipeline

Верзија на APIv1

# Available only after support activation
export FFAST_PIPELINE_KEY="issued-after-review"

curl -X POST https://ffast.app/v1/resolve \
  -H "X-API-Key: $FFAST_PIPELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID"}'

За безбедноста на креденцијалите, FFast проверува серверско складирање на тајни пред да не вгради клиентски пакет. Овој брз преглед исто така не прави јасни јавни записи или репозитории.

Решете врска

FFast пристапува кон операцијата Resolve преку детекција на извор, потоа форматира од еден поднесен URL. Брзиот преглед не задржува измислени излези експлицитно.

ПОШТА/v1/resolveОпсег: решавање

Поле	Тип на датотека	Задолжително	Опис
`fast_source`	HTTPS адреса	Да	Јавна или овластена страница на медиумите за анализа.
`tenant`	низа	Не.	Доделен домен на закупецот.Обично се испушта.

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

За Формат идентификатор, FFast ја проверува вратената вредност непроменета пред достапноста по врска. Овој брз преглед исто така не прави јасна етикета за квалитет на претпоставка.

Креирајте и следете работа за преземање

FFast ракува со креирање на работа со прво идентификување на асинхрона подготовка. Следува со кратко барање HTTP и го држи ограниченото извршување на работниците во вид.

ПОШТА/v1/jobsОпсег: работни места

Поле	Тип на датотека	Задолжително	Опис
`fast_source`	HTTPS адреса	Да	Истиот нормализиран извор поднесен за решавање.
`output_code`	низа	Да	Точен ID од одговорот за решавање.
`tenant`	низа	Не.	Доделен домен на закупецот.Обично се испушта.

curl -X POST https://ffast.app/v1/jobs \
  -H "X-API-Key: $FFAST_PIPELINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fast_source":"https://www.youtube.com/watch?v=VIDEO_ID","output_code":"18"}'

1202 ПрифатеноЗачувај pipeline_run.

2Статус на анкетатаGET /v1/jobs/{pipeline_run} со истиот клуч.

3ПодготвенОтворете ја потпишаната URL за преземање.

Статус	Значење	Дејство на клиентот
`queued`	Прифатено во ограничената редица.	Анкета повторно со повраток.
`extracting`	Освежување на изворните метаподатоци или рутата.	Продолжете со анкетирање.
`processing`	Преземање, ремуксирање или спојување.	Прикажи напредок на серверот.
`ready`	Потпишано преземање е достапно.	Испратете го URL-то до корисникот.
`failed`	Грешка во структурата на терминалот.	Прочитај `error_code`.Повторете го обидот само кога ќе бидете советувани.
`expired`	Привремениот излез беше отстранет.	Креирајте нова работа.

curl https://ffast.app/v1/jobs/PIPELINE_RUN \
  -H "X-API-Key: $FFAST_PIPELINE_KEY"

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

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

Брзиот преглед на FFast прегледува еден плик што не е 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	Невалидна URL, тело или недостапен формат.	Поправете го барањето. Обидете се повторно за формати.
401	Клучот недостасува, е невалиден, истечен или со погрешен опсег.	Проверете ги акредитивите на страната на серверот.
403	Политиката на станарот или изворот го одби барањето.	Не заобиколувајте ја политиката.Контактирајте со поддршката.
404	Непозната или истечена работа.	Креирајте нова работа ако е соодветно.
429	Достигнато е ограничувањето на барањето или активната задача.	Чест. `retry_after_seconds`.
503	Ред/капацитет или горен тек привремено недостапен.	Повторете со експоненцијално повлекување и треперење.

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

FFast активира измерени квоти кои го одржуваат одговорот на предавањето без да поставуваат небезбеден товар на платформите нагоре.

Користете идемпотентна логика на апликацијата и никогаш не започнувајте дупликатни задачи за истиот клик на корисникот.
Кешот ги решава метаподатоците накратко, но секогаш ги третира потпишаните URL-адреси за преземање како истекување.
Користете ограничен експоненцијален поврат со тресење за 429, 503 и повторливи грешки.
Обработувајте само јавни медиуми или медиуми до кои имате овластување за пристап. DRM и контролите на пристап не се заобиколуваат.
Чувајте ги идентификаторите на барања и идентификаторите на задачи во приватни оперативни дневници. Не ги запишувајте испратените URL-адреси непотребно.

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

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

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

Дайте на FFast концизен преглед на производот, проекција на сообраќајот и листа на платформи. Наведете дали се потребни проверки на метаподатоци, подготвени задачи или и двете за да се осигура дека издадениот клуч одговара на фактичкиот работен тек.

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