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

Изграждане на изтегляния с DWYT

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

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

Бърз старт

Картата на формата на DWYT преглежда активираните от поддръжката идентификационни данни за хоста на API.Тя показва присвоена крайна точка на наемателя следваща и не затъмнява пътя на повикване само на сървъра.

URL на клиентаhttps://dwyt.app
УдостоверяванеX-API-Key: pending_activation_…
Профил на клиентаDwytFlow
Версия на APIv1
# Available only after support activation
export DWYT_FLOW_SECRET="issued-after-review"

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

За безопасност на данните за самоличност, DWYT започва с тайно съхранение от страна на сървъра.Неговата карта на формата сдвоява това без вграждане на клиентски пакети и завършва без публични дневници или хранилища.

02

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

Картата на формата на DWYT преглежда откриването на източника за операцията Той показва формати от един подаден URL адрес следващ и не затъмнява никакви измислени изходи.

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

За идентификатора на формата, DWYT започва с върнатата стойност непроменена.Неговата карта на формата сдвоява това с наличността на връзката и завършва без етикет за качество на предположението.

03

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

За създаване на работа, DWYT проверява асинхронната подготовка преди кратка заявка Тази карта на формата също така прави ясно изпълнението на ограничени работници.

ПОС/v1/jobsОбхват: работни места
ПолеТипЗадължителноОписание на продукта
public_mediaHTTPS адресДаСъщият нормализиран източник, подаден за разрешаване.
rendition_keyнизДаТочен идентификатор от отговора за разрешаване.
tenantнизНе.Присвоен домейн на наемателя. Обикновено се пропуска.
curl -X POST https://dwyt.app/v1/jobs \
  -H "X-API-Key: $DWYT_FLOW_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"public_media":"https://www.youtube.com/watch?v=VIDEO_ID","rendition_key":"18"}'
1202 ПриетоЗапазване flow_id.
2Статус на анкетатаGET /v1/jobs/{flow_id} със същия ключ.
3ГотовОтворете подписания адрес за изтегляне.
СъстояниеЗначениеДействие на клиента
queuedДопуснат до ограничената опашка.Анкета отново с отстъпление.
extractingОбновяване на изходните метаданни или маршрут.Продължете да гласувате.
processingИзтегляне, ремиксиране или сливане.Показване на напредъка на сървъра.
readyПодписано изтегляне е налично.Изпратете адреса на потребителя.
failedТерминална структурирана грешка.Прочетете error_codeПовторете опита само когато ви бъде препоръчано.
expiredВременният изход беше премахнат.Създаване на нова работа.
curl https://dwyt.app/v1/jobs/FLOW_ID \
  -H "X-API-Key: $DWYT_FLOW_SECRET"

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

04

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

DWYT обработва договора за грешка, като първо идентифицира един плик, който не е 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

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

DWYT преглежда интеграцията, преди да избере квоти, които защитават както видеоклиента, така и услугите нагоре по веригата.

Картата на формата на DWYT преглежда активирането преди проучване за достъп до Тя показва присвоено удостоверяване следващо и не затъмнява документираните форми на заявки.

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

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

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

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