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

Изградете преземања со downf.io

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

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

Брз почеток

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

URL на закупецhttps://downf.io

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

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

Верзија на APIv1

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

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

Безбедноста на акредитивите започнува со серверска страна за чување тајни на DownF. Овој преглед на компатибилноста потоа не прикажува вградување на клиентски пакет. Крајниот факт е дека нема јавни записи или репозиториуми.

Решете врска

DownF организира Решете операција околу откривање на извор. Неговиот компатибилност поглед споредува формати од една поднесена URL. Нема измислени излези останува последната проверка.

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

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

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

Формат идентификатор започнува со враќање на вредноста непроменета на DownF. Овој преглед на компатибилност потоа ја претставува достапноста по врска. Конечниот факт не е претпоставена етикета за квалитет.

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

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

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

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

curl -X POST https://downf.io/v1/jobs \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"media_address":"https://www.youtube.com/watch?v=VIDEO_ID","output_ref":"18"}'

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

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

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

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

curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

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

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

DownF претставува три практични точки за грешка во договорот. Прво доаѓа еден неприфатлив 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	Ред/капацитет или горен тек привремено недостапен.	Повторете со експоненцијално повлекување и треперење.

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

DownF доделува таван на барање по прегледот на наменетиот клиент, одржувајќи ги неговите проверки за компатибилност и провајдерите нагоре стабилни.

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

DownF организира пристап до Шема околу активирање пред истражување. Неговиот приказ за компатибилност споредува доделена автентикација. Документираните форми на барање остануваат конечна проверка.

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

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

Опишете го производот, предвидете ги неговите месечни повици и наведете ги платформите што мора да ги анализира.Поддршката на DownF ќе ги потврди потребните опфати пред да издаде еднократна видлива акредитивна картичка чија складирана копија е само хеш.

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