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

Изграждане на изтегляния с downf.io

DownF поддържа изпълнението на API деактивирано, докато оператор не прегледа случая на съвместимост. Примерите описват планирания договор, докато реалните идентификационни данни и квоти пристигат само чрез активиране на поддръжката.

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

Бърз старт

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. Този изглед за съвместимост не представя вграждане на клиентски пакет. Последният факт е, че няма публични дневници или хранилища.

02

Разрешаване на връзка

DownF организира операцията Resolve около откриването на източника. Неговият изглед за съвместимост сравнява формати от един подаден URL. Няма измислени изходи, което остава последната проверка.

ПОС/v1/resolveОбхват: решаване
ПолеТипЗадължителноОписание на продукта
media_addressHTTPS адресДаПублична или упълномощена медийна страница, която да анализира.
tenantнизНе.Присвоен домейн на наемателя. Обикновено се пропуска.
{
  "success": true,
  "platform": "youtube",
  "title": "Example video",
  "formats": [
    {"id":"18","type":"video","quality":"360p","container":"mp4"}
  ],
  "cached": false
}

Идентификаторът на формата започва с върнатата стойност без промяна в DownF. Този изглед за съвместимост след това представя наличността на връзка. Крайният факт е, че няма предположена етикета за качество.

03

Създаване и проследяване на задача за изтегляне

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

ПОС/v1/jobsОбхват: работни места
ПолеТипЗадължителноОписание на продукта
media_addressHTTPS адресДаСъщият нормализиран източник, подаден за разрешаване.
output_refнизДаТочен идентификатор от отговора за разрешаване.
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ГотовОтворете подписания адрес за изтегляне.
СъстояниеЗначениеДействие на клиента
queuedДопуснат до ограничената опашка.Анкета отново с отстъпление.
extractingОбновяване на изходните метаданни или маршрут.Продължете да гласувате.
processingИзтегляне, ремиксиране или сливане.Показване на напредъка на сървъра.
readyПодписано изтегляне е налично.Изпратете адреса на потребителя.
failedТерминална структурирана грешка.Прочетете error_codeПовторете опита само когато ви бъде препоръчано.
expiredВременният изход беше премахнат.Създаване на нова работа.
curl https://downf.io/v1/jobs/TRANSFER_REF \
  -H "X-API-Key: $DOWNF_ACCESS_TOKEN"

Изгледът за съвместимост на DownF преглежда едносекундно първоначално изчакване за анкетиране на работни места.Показва ограничено отстъпление след това и не затъмнява временно подписаната доставка.

04

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

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

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

DownF определя таван на заявката, след като прегледа предвидения клиент, като поддържа стабилни своите проверки за съвместимост и доставчиците нагоре по веригата.

DownF организира достъпа до Schema около активирането преди изследването. Неговият режим за съвместимост сравнява зададената автентикация. Документираните форми на заявка остават последната проверка.

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

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

Опишете продукта, прогнозирате месечните му обаждания и изброите платформите, които трябва да анализира. Поддръжката на DownF ще потвърди необходимите обхвати преди издаването на еднократен видим идентификатор, чиято съхранена копие е само хеш.

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