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

Изграждане на изтегляния с 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`	низ	Да	Точен идентификатор от отговора за разрешаване.
`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ГотовОтворете подписания адрес за изтегляне.

Състояние	Значение	Действие на клиента
`queued`	Допуснат до ограничената опашка.	Анкета отново с отстъпление.
`extracting`	Обновяване на изходните метаданни или маршрут.	Продължете да гласувате.
`processing`	Изтегляне, ремиксиране или сливане.	Показване на напредъка на сървъра.
`ready`	Подписано изтегляне е налично.	Изпратете адреса на потребителя.
`failed`	Терминална структурирана грешка.	Прочетете `error_code`Повторете опита само когато ви бъде препоръчано.
`expired`	Временният изход беше премахнат.	Създаване на нова работа.

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

Започва проверка на задачата с едносекундно първоначално изчакване на FFast. Следващият изглед обхваща ограничено оттегляне. Страницата запазва временно подписаната доставка видима.

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

Бързият преглед на FFast преглежда един не-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	Невалиден адрес, тяло или недостъпен формат.	Коригирайте заявката. Решете отново за формати.
401	Липсва, невалиден, изтекъл или с грешен обхват ключ.	Проверете идентификационните данни от страна на сървъра.
403	Наемател или източник политика отхвърли искането.	Не заобикаляйте правилата. Свържете се с поддръжката.
404	Неизвестна или изтекла работа.	Създайте нова работа, ако е подходящо.
429	Достигане на ограничението за заявки или активни задачи.	Чест. `retry_after_seconds`.
503	Опашка/капацитет или нагоре по веригата временно недостъпни.	Опитайте отново с експоненциално отстъпление и трептене.

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

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

Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
Използвайте ограничен експоненциален отстъп с трептене за 429, 503 и повторяеми грешки.
Обработвайте само публични медии или медии, до които имате разрешение за достъп. DRM и контролите за достъп не се заобикалят.
Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.

FFast подхожда към достъпа до Схемата чрез активиране преди изследване, след което се назначава удостоверяване. Бързият преглед поддържа документираните форми на заявките ясни.

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

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

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

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