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

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

DownF drži izvršenje API-ja onemogućenim dok operater ne pregleda slučaj upotrebe kompatibilnosti. Primeri opisuju planirani ugovor, dok stvarni akreditivi i kvote stižu samo putem aktivacije podrške.

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

Брзи почетак

DownF organizuje API host oko akreditiva aktiviranih podrškom. Njegov prikaz kompatibilnosti upoređuje dodeljenu krajnju tačku zakupca. Putanja poziva samo serveru ostaje konačna provera.

УРЛ закупцаhttps://downf.io

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

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

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

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

Bezbednost akreditiva počinje skladištenjem tajni na serverskoj strani na DownF-u. Ovaj prikaz kompatibilnosti zatim ne prikazuje ugrađivanje klijentskog paketa. Konačna činjenica je da nema javnih zapisa ili repozitorijuma.

Решите везу

DownF organizuje Resolve operaciju oko detekcije izvora. Njegov prikaz kompatibilnosti upoređuje formate sa jedne dostavljene URL adrese. Nijedan izmišljeni izlaz ne ostaje kao konačna provera.

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

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

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

Identifikator formata počinje sa vraćenom vrednošću nepromenjenom na DownF. Ovaj prikaz kompatibilnosti zatim prikazuje dostupnost po linku. Konačna činjenica je da nema pretpostavljene oznake kvaliteta.

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

Креирање посла почиње са асинхроном припремом на ДоунФ-у.Следећи приказ покрива кратак ХТТП захтев.Страница задржава ограничено извршење радника видљиво.

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

Поље	Тип	Обавезно	Опис
`media_address`	ХТТПС УРЛ	Да	Исти нормализовани извор поднео да се реши.
`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 predstavlja tri praktične tačke za Error contract. Prva je jedan non-2xx omot. Zatim pogled kompatibilnosti pokriva ID zahteva za podršku. Njegova poslednja tačka je predvidivo rukovanje klijentom.

{
  "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	Ред / капацитет или узводно привремено недоступан.	Поново покушајте са експоненцијалним бекоффом и џитером.

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

ДоунФ додељује плафон захтева након прегледа намењеног клијента, одржавајући своје провере компатибилности и узводне провајдере стабилним.

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

DownF organizuje pristup Shemi oko aktivacije pre istraživanja. Njegov prikaz kompatibilnosti upoređuje dodeljenu autentifikaciju. Dokumentovani oblici zahteva ostaju konačna provera.

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

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

Opišite proizvod, predvidite njegove mesečne pozive i navedite platforme koje mora analizirati. Podrška DownF-a će potvrditi potrebne opsege pre izdavanja jednokratnog vidljivog akreditiva čija je sačuvana kopija samo heš.

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