Pouze náhled — vyžaduje aktivaci

Sestavte stahování s Insts

Pracovní plocha Insts níže je dokumentace pro potenciálního klienta. Operátorova kontrola probíhá před vytvořením jakéhokoli spustitelného pověření nebo povolení volání.

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

Rychlý start

Hostitel API začíná pověřením aktivovaným podporou na Insts. Další zobrazení pokrývá přiřazený koncový bod nájemce. Stránka udržuje viditelnou cestu volání pouze na serveru.

URL klientahttps://insts.io

AutentizaceX-API-Key: pending_activation_…

Profil klientaInstsConnect

Verze APIv1

# 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"}'

Serverové tajné úložiště je výchozím bodem pro bezpečnost přihlašovacích údajů na Insts. Kontrolní stanoviště pak neprezentuje žádné vkládání klientského balíčku a nevysvětluje žádné veřejné protokoly ani úložiště kódu.

Vyřešit odkaz

Proces řešení začíná detekcí zdroje na Insts. Následující zobrazení pokrývá formáty z jedné odeslané URL. Stránka nezobrazuje žádné vymyšlené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`shared_post`	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
}

Vrácená hodnota beze změny je výchozím bodem pro identifikátor formátu na Insts. Kontrolní stolice poté zobrazuje dostupnost pro každý odkaz a nevysvětluje žádný odhadovaný štítek kvality.

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

Insts usnadňuje přehledné vytvoření úlohy. Stránka začíná asynchronní přípravou, pokračuje krátkým požadavkem HTTP a jasně uvádí omezené spuštění pracovního procesu.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`shared_post`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`asset_option`	ř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://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 PřijatoSave connect_job.

2Stav hlasováníGET /v1/jobs/{connect_job} 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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Pro Job polling kontroluje Insts počáteční čekání jedné sekundy před omezeným zpětným odskokem. Tato inspekční lavice také jasně zajišťuje dočasné podepsané doručení.

Předvídatelné chyby

Chybová smlouva začíná jedním obalem mimo rozsah 2xx na Insts. Tato inspekční lavice poté zobrazí ID požadavku na podporu. Konečným faktem je předvídatelné zpracování klienta.

{
  "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

Insts stanoví omezení rychlosti v době kontroly, aby chránil pracovní prostor kontroly a každou trasu poskytovatele.

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ě.

Přístup ke schématu začíná aktivací před průzkumem na Insts. Další zobrazení pokrývá přiřazené ověřování. Stránka ponechává zdokumentované tvary požadavků viditelné.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Sdělte případ použití pracovní plochy, odhadovaný počet volání a služby pod kontrolou. Insts před zobrazením přihlašovacích údajů tenanta jednou přezkoumá tuto hranici a převede je na uložený hash.

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