Pouze náhled — vyžaduje aktivaci

Sestavte stahování s Insto

Insto představuje návrh integrace vizuálních médií k posouzení. Živá analýza a požadavky na úlohy zůstávají nedostupné, dokud podpora neudělí oprávnění omezená na konkrétní web.

InstoMediaJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Insto při popisu hostitele API začíná přístupovými údaji aktivovanými podporou. Přehled stahování je spojuje s přiděleným koncovým bodem webu a voláním výhradně ze serveru.

URL klientahttps://insto.app

AutentizaceX-API-Key: pending_activation_…

Profil klientaInstoMedia

Verze 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 uvádí tři praktické zásady bezpečnosti přístupových údajů: ukládání tajných údajů na serveru, jejich vyloučení z klientského balíčku a zákaz jejich zveřejňování v protokolech nebo repozitářích.

Vyřešit odkaz

Insto při operaci vyhodnocení nejprve rozpozná zdroj. Přehled stahování k němu přiřadí formáty z jediné odeslané URL a nevytváří žádné smyšlené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`media_source`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

Insto uvádí tři praktické zásady pro identifikátor formátu: vrácená hodnota zůstává beze změny, dostupnost se posuzuje pro jednotlivé odkazy a označení kvality se neodhaduje.

Vytvoření a sledování úlohy stahování

Insto při vytváření úloh používá asynchronní přípravu. Přehled stahování vysvětluje krátký požadavek HTTP a časově či jinak omezené zpracování pracovním procesem.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`media_source`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`media_variant`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave prepare_id.

2Stav hlasováníGET /v1/jobs/{prepare_id} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto při vysvětlování dotazování na stav úlohy nejprve uvádí počáteční čekání jednu sekundu. Přehled stahování poté popisuje prodlužování prodlevy s horní hranicí a dočasné doručení pomocí podepsané adresy.

Předvídatelné chyby

Insto při popisu chybového rozhraní rozlišuje jednotnou strukturu odpovědi se stavem mimo rozsah 2xx a identifikátor požadavku pro podporu. Přehled stahování vysvětluje také předvídatelné zpracování chyb klientem.

{
  "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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

Insto přizpůsobuje limity volání případu použití vizuálních médií a sítím, které bude schválený klient kontaktovat.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

Insto při přístupu ke schématu nejprve vyžaduje aktivaci. Přehled stahování vysvětluje přidělené ověřování a dokumentované struktury požadavků.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Popište produkt pro práci s vizuálními médii, očekávané měsíční využití a typy příspěvků, které chcete zpracovávat. Insto uděluje pouze nezbytná oprávnění pro analýzu nebo přípravu a nikdy neukládá token v čitelné podobě.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.