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

Preuzimanja izgradnje sa Insts

Radna tabla Insts ispod je dokumentacija za potencijalnog klijenta. Pregled operatera dolazi pre nego što se kreira bilo koji izvršni akreditiv ili dozvola za poziv.

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

Брзи почетак

API host počinje sa podrškom za aktivirane akreditive na Insts. Sledeći prikaz pokriva dodeljenu krajnju tačku zakupca. Stranica održava vidljiv put poziva samo za server.

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

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

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

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

# Available only after support activation
export INSTS_CONNECT_SECRET="issued-after-review"

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

Skladištenje tajni na strani servera je polazna tačka za bezbednost akreditiva na Insts. Radna stanica za inspekciju zatim ne prikazuje ugrađivanje klijentskog paketa i ne objašnjava javne dnevnike ili repozitorijume.

Решите везу

Operacija rešavanja počinje detekcijom izvora na Insts. Sledeći prikaz pokriva formate sa jednog dostavljenog URL-a. Stranica ne prikazuje izmišljene izlaze.

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

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

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

Vraćena nepromenjena vrednost je polazna tačka za identifikator formata na Insts. Radna klupa za inspekciju zatim prikazuje dostupnost po linku i objašnjava odsustvo pretpostavljene oznake kvaliteta.

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

Insts olakšava skeniranje kreiranja posla. Stranica počinje sa asinhronom pripremom, prelazi na kratak HTTP zahtev i jasno navodi ograničeno izvršavanje radnika.

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

Поље	Тип	Обавезно	Опис
`shared_post`	ХТТПС УРЛ	Да	Исти нормализовани извор поднео да се реши.
`asset_option`	низ	Да	Тачан ИД из одговора на решавање.
`tenant`	низ	Не.	Додељени домен закупца.Обично се изоставља.

curl -X POST https://insts.io/v1/jobs \
  -H "X-API-Key: $INSTS_CONNECT_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"shared_post":"https://www.youtube.com/watch?v=VIDEO_ID","asset_option":"18"}'

1202 ПрихваћеноСачувајте connect_job.

2Статус анкетеGET /v1/jobs/{connect_job} истим кључем.

3СпреманОтворите потписан УРЛ за преузимање.

Статус	Значење	Радња клијента
`queued`	Примљен у ограничени ред.	Анкета поново са бекоффом.
`extracting`	Освежавање изворних метаподатака или руте.	Наставите са анкетирањем.
`processing`	Преузимање, ремуковање или спајање.	Прикажи напредак сервера.
`ready`	Потписано преузимање је доступно.	Пошаљите УРЛ кориснику.
`failed`	Терминал структурирана грешка.	Прочитај `error_code`.Поново покушајте само када се саветује.
`expired`	Привремени излаз је уклоњен.	Креирајте нови посао.

curl https://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Za Job polling, Insts proverava početno čekanje od jedne sekunde pre ograničenog povlačenja. Ova inspekcijska klupa takođe čini privremenu potpisanu isporuku jasnom.

Предвидљиве грешке

Greška ugovora počinje sa jednim ne-2xx omotačem na Insts. Ova inspekcijska klupa zatim prikazuje ID zahteva za podršku. Konačni podatak 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	Ред / капацитет или узводно привремено недоступан.	Поново покушајте са експоненцијалним бекоффом и џитером.

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

Instsуспоставља границе стопе у време прегледа како би заштитио радни простор инспекције и сваку руту провајдера.

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

Pristup šemi počinje aktivacijom pre istraživanja na Insts. Sledeći prikaz pokriva dodeljenu autentifikaciju. Stranica održava vidljive dokumentovane oblike zahteva.

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

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

Podelite slučaj upotrebe radne površine, procenjenu broj poziva i usluge pod istragom. Insts pregleda tu granicu pre nego što se korisnički podaci zakupca prikažu jednom i smanje na sačuvani heš.

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