Csak előzetes verzió – aktiválás szükséges

Insts letöltések készítése

Az alábbi Insts munkaasztal egy leendő ügyfél dokumentációja. Az operátor felülvizsgálata megelőzi a végrehajtható hitelesítő adatok vagy hívásengedély létrehozását.

InstsConnectJSON HTTPS-en keresztülAszinkron feladatokHatókörrel rendelkező hitelesítő adatok

Gyors kezdés

Az API hoszt támogatással aktivált hitelesítő adatokkal kezdődik a Insts-en. A következő nézet egy hozzárendelt bérlő végpontját fedi le. Az oldal egy szerver-oldali hívási útvonalat tart láthatóan.

Bérlő URL-jehttps://insts.io

HitelesítésX-API-Key: pending_activation_…

Az ügyfél profiljaInstsConnect

Az API verziójav1

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

A szerveroldali titkos tárolás a hitelesítő adatok biztonságának kiindulópontja a Insts-en. Egy ellenőrző állvány ezután nem mutat be klienscsomag beágyazást, és nem magyaráz nyilvános naplókat vagy tárolókat.

Hivatkozás feloldása

A feloldás a Insts forrásának észlelésével kezdődik. A következő nézet egy benyújtott URL formátumait tartalmazza, az oldal nem tartja láthatónak a kitalált kimeneteket.

POST/v1/resolveHatály: megoldani

Mező	Típus	Kötelező	Leírás
`shared_post`	HTTPS URL	Igen.	Nyilvános vagy engedélyezett médiaoldal elemzése.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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

A változatlanul visszaadott érték a Formátumazonosító kiindulópontja a Insts-en. Egy ellenőrzőpad ezután bemutatja a linkenkénti elérhetőséget és megmagyarázza, hogy nincs becsült minőségi címke.

Letöltési feladat létrehozása és követése

A Insts megkönnyíti a Feladat létrehozását. Az oldal aszinkron előkészítéssel kezd, majd egy rövid HTTP-kéréssel folytatódik, és egyértelműen kijelenti a kötött munkavégzést.

POST/v1/jobsHatály: munkahelyek

Mező	Típus	Kötelező	Leírás
`shared_post`	HTTPS URL	Igen.	Ugyanaz a normalizált forrás került benyújtásra megoldásra.
`asset_option`	karakterlánc	Igen.	Egy pontos azonosító a feloldási válaszból.
`tenant`	karakterlánc	Nem.	Hozzárendelt bérlői domain. Általában elhagyható.

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 ElfogadvaMentés connect_job.

2A szavazás állapotaGET /v1/jobs/{connect_job} ugyanazzal a kulccsal.

3KészNyissa meg az aláírt letöltési URL-t.

Állapot	Jelentése	Ügyfél akció
`queued`	Felvétel a korlátozott várólistára.	Újra szavazás hátraléptetéssel.
`extracting`	Forrás metaadatok vagy útvonal frissítése.	Folytasd a szavazás.
`processing`	Letöltés, remuxing vagy egyesítés.	Kiszolgáló előrehaladásának megjelenítése.
`ready`	Aláírt letöltés elérhető.	Küldje el az URL-t a felhasználónak.
`failed`	Terminál strukturált hiba.	Olvasd el `error_code`Csak akkor próbálkozzon újra, ha azt tanácsolják.
`expired`	Az ideiglenes kimenetet eltávolították.	Hozzon létre egy új feladatot.

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

A Job polling esetében a Insts ellenőrzi az egy másodperces kezdeti várakozást a korlátozott visszalépés előtt. Ez az ellenőrzőpad az ideiglenes aláírt kézbesítést is egyértelművé teszi.

Kiszámítható hibák

A hibaszerződés egy nem 2xx borítékkal kezdődik a Insts-en. Ez az ellenőrző pad ezután bemutat egy támogatási kérelem azonosítót. A végső tény a kiszámítható klienskezelés.

{
  "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	Tipikus jelentése	Akció
400	Érvénytelen URL, tartalom vagy nem elérhető formátum.	Javítsa a kérést. Oldja meg újra a formátumokért.
401	Hiányzó, érvénytelen, lejárt vagy rossz hatókörű kulcs.	Ellenőrizze a kiszolgálóoldali hitelesítő adatokat.
403	A bérlő vagy a forrás irányelve elutasította a kérést.	Ne kerülje meg a szabályzatot. Lépjen kapcsolatba a támogatással.
404	Ismeretlen vagy lejárt munka.	Ha szükséges, hozzon létre egy új feladatot.
429	Kérés vagy aktív feladat limit elérve.	Becsület `retry_after_seconds`.
503	Sor/kapacitás vagy upstream ideiglenesen nem elérhető.	Próbálja újra exponenciális visszalépéssel és jitterrel.

Üzemeltetési szerződés

A Insts a felülvizsgálat idején sebességkorlátokat hoz létre az ellenőrzési munkaterület és minden szolgáltatói útvonal védelme érdekében.

Használjon idempotens alkalmazáslogikát, és soha ne indítson párhuzamos feladatokat ugyanahhoz a felhasználói kattintáshoz.
A gyorsítótár oldja meg a metaadatokat röviden, de a aláírt letöltési URL-eket mindig lejártnak tekintse.
Használjon korlátozott exponenciális visszalépést jitterrel 429, 503 és újrapróbálható hibák.
Csak nyilvános vagy olyan médiafájlokat dolgozzon fel, amelyekhez Ön jogosult hozzáférni, és ne kerülje meg a DRM-et és a hozzáférés-vezérlést.
Tartsa meg a kérésazonosítókat és a feladatazonosítókat a privát működési naplókban. Ne naplózza szükségtelenül a beküldött URL-eket.

A séma-hozzáférés aktiválással kezdődik, mielőtt a Insts-en felfedezés történik. A következő nézet a hozzárendelt hitelesítést fedi le. Az oldal dokumentált kérések formáit tartja láthatóan.

ÜZEMELTETŐ ÁLTAL ELLENŐRZÖTT HOZZÁFÉRÉS

Aktiválás a támogatáson keresztül

Ossza meg a munkapad használati esetét, a becsült hívásszámot és az ellenőrzés alatt álló szolgáltatásokat. A Insts áttekinti ezt a határt, mielőtt egy bérlői hitelesítő adat egyszer megjelenik és egy tárolt hash-re csökken.

Aktiválás kérése A kulcsok bérlői hatókörűek, visszavonhatók, és a Kapcsolatfelvételi űrlapon keresztül adhatóak ki. Névtelen parancsfájlok nem tudnak letöltő munkát végrehajtani.