https://insto.appИзграждане на изтегляния с Insto
InstoАнализът на живо и заявките за работа остават недостъпни, докато поддръжката не предостави разрешение с обхват на наемателя.
Бърз старт
За API хост, Insto започва с активирани от поддръжката идентификационни данни.Неговият преглед на изтеглянето сдвоява това с присвоена крайна точка на наемателя и завършва с път на повикване само на сървъра.
X-API-Key: pending_activation_…InstoMediav1# 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. Първо идва тайно съхранение от страна на сървъра. Прегледът на изтеглянето след това не обхваща вграждане на клиентски пакети. Неговата последна точка е без публични дневници или хранилища.
Разрешаване на връзка
За операцията Resolve, Insto започва с откриване на източника, Прегледът му за изтегляне сдвоява това с формати от един подаден адрес и завършва без измислени изходи.
/v1/resolveОбхват: решаване| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
media_source | HTTPS адрес | Да | Публична или упълномощена медийна страница, която да анализира. |
tenant | низ | Не. | Присвоен домейн на наемателя. Обикновено се пропуска. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Insto представя три практически точки за идентификатор на формата. Първо идва върнатата стойност непроменена. Прегледът на изтеглянето след това обхваща наличността на връзката. Неговата последна точка е без предполагаем етикет за качество.
Създаване и проследяване на задача за изтегляне
Insto организира създаването на работни места около асинхронна подготовка. Неговият преглед на изтеглянето сравнява кратка HTTP заявка. Ограниченото изпълнение на работниците остава последната проверка.
/v1/jobsОбхват: работни места| Поле | Тип | Задължително | Описание на продукта |
|---|---|---|---|
media_source | HTTPS адрес | Да | Същият нормализиран източник, подаден за разрешаване. |
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"}'prepare_id.GET /v1/jobs/{prepare_id} със същия ключ.| Състояние | Значение | Действие на клиента |
|---|---|---|
queued | Допуснат до ограничената опашка. | Анкета отново с отстъпление. |
extracting | Обновяване на изходните метаданни или маршрут. | Продължете да гласувате. |
processing | Изтегляне, ремиксиране или сливане. | Показване на напредъка на сървъра. |
ready | Подписано изтегляне е налично. | Изпратете адреса на потребителя. |
failed | Терминална структурирана грешка. | Прочетете error_codeПовторете опита само когато ви бъде препоръчано. |
expired | Временният изход беше премахнат. | Създаване на нова работа. |
curl https://insto.app/v1/jobs/PREPARE_ID \
-H "X-API-Key: $INSTO_MEDIA_TOKEN"В Insto първоначалното изчакване от една секунда идва на първо място, когато се обяснява Това преглеждане на изтеглянето следва с ограничено отстъпление и се затваря при временна подписана доставка.
Предсказуеми грешки
За да обясним договора за грешка, 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 | Опашка/капацитет или нагоре по веригата временно недостъпни. | Опитайте отново с експоненциално отстъпление и трептене. |
Договор за експлоатация
Insto приспособява лимитите за повикване към случая на използване на визуални медии и мрежите, с които одобреният клиент ще се свърже.
- Използвайте idempotent логика на приложението и никога не започват дублирани работни места за един и същ потребител клик.
- Кешът разрешава метаданните за кратко, но винаги третира подписаните адреси за изтегляне като изтичащи.
- Използвайте ограничен експоненциален отстъп с трептене за
429,503и повторяеми грешки. - Обработвайте само публични медии или медии, до които имате разрешение за достъп. DRM и контролите за достъп не се заобикалят.
- Съхранявайте идентификационните номера на заявките и идентификационните номера на задачите в частни оперативни регистрационни файлове.
За достъп до схемата, Insto започва с активиране преди проучване.Неговият преглед на изтеглянето сдвоява това с присвоено удостоверяване и завършва с документирани форми на заявка.
Активиране чрез поддръжка
Определете визуално-медийния продукт, очакваното месечно използване и типовете публикации, които планирате да обработвате.Instoпредоставя само необходимите обхвати за анализ или подготовка и никога не съхранява четимия токен.
Заявка за активиране Ключовете са с обхват на наемателя, отменяеми и издадени чрез формата за връзка.Анонимните скриптове не могат да изпълняват работа за изтегляне.