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

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

InstoАнализът на живо и заявките за работа остават недостъпни, докато поддръжката не предостави разрешение с обхват на наемателя.

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

Бърз старт

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

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

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

Insto представя три практически точки за безопасност на Credential. Първо идва тайно съхранение от страна на сървъра. Прегледът на изтеглянето след това не обхваща вграждане на клиентски пакети. Неговата последна точка е без публични дневници или хранилища.

02

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

За операцията Resolve, Insto започва с откриване на източника, Прегледът му за изтегляне сдвоява това с формати от един подаден адрес и завършва без измислени изходи.

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

Insto представя три практически точки за идентификатор на формата. Първо идва върнатата стойност непроменена. Прегледът на изтеглянето след това обхваща наличността на връзката. Неговата последна точка е без предполагаем етикет за качество.

03

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

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

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

В Insto първоначалното изчакване от една секунда идва на първо място, когато се обяснява Това преглеждане на изтеглянето следва с ограничено отстъпление и се затваря при временна подписана доставка.

04

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

За да обясним договора за грешка, Insto отделя един не-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

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

Insto приспособява лимитите за повикване към случая на използване на визуални медии и мрежите, с които одобреният клиент ще се свърже.

За достъп до схемата, Insto започва с активиране преди проучване.Неговият преглед на изтеглянето сдвоява това с присвоено удостоверяване и завършва с документирани форми на заявка.

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

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

Определете визуално-медийния продукт, очакваното месечно използване и типовете публикации, които планирате да обработвате.Instoпредоставя само необходимите обхвати за анализ или подготовка и никога не съхранява четимия токен.

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