Numai previzualizare — activare necesară

Construiți descărcări cu Insts

Workbench-ul Insts de mai jos este documentație pentru un potențial client. Revizuirea de către operator are loc înainte de a fi creată orice acreditare executabilă sau permisiune de apel.

InstsConnectJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

Gazda API începe cu acreditări activate pentru suport pe Insts. Următoarea vizualizare acoperă un endpoint de tenant atribuit. Pagina păstrează vizibilă o cale de apel numai pentru server.

URL- ul entității găzduitehttps://insts.io

AutentificareX-API-Key: pending_activation_…

Profilul de clientInstsConnect

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

Stocarea secretelor pe server este punctul de plecare pentru siguranța Credential pe Insts. Un banc de inspecție nu prezintă apoi nicio încorporare în pachetul client și nu oferă niciun jurnal public sau depozit.

Rezolvarea unui link

Operațiunea Resolve începe cu detectarea sursei pe Insts. Următoarea vizualizare acoperă formate dintr-o singură adresă URL trimisă. Pagina nu afișează rezultate inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`shared_post`	URL HTTPS	Da.	Pagina media publică sau autorizată pentru a analiza.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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

Valoarea returnată neschimbată este punctul de plecare pentru identificatorul de format pe Insts. Apoi, un banc de inspecție prezintă disponibilitatea pentru fiecare link și explică faptul că nu există o etichetă de calitate presupusă.

Crearea și urmărirea unei lucrări de descărcare

Insts face Crearea de joburi ușor de parcurs. Pagina începe cu pregătire asincronă, trece la o solicitare HTTP scurtă și indică clar execuția limitată a workerului.

POST/v1/jobsDomeniul de aplicare: locuri de muncă

Câmp	Tip	Obligatoriu	Descrierea
`shared_post`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`asset_option`	șir	Da.	Un ID exact din răspunsul de rezolvare.
`tenant`	șir	Nu.	Domeniul entității găzduite atribuite. De obicei omis.

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 AcceptatSalvează connect_job.

2Starea sondajuluiGET /v1/jobs/{connect_job} cu aceeași cheie.

3Gata.Deschideți URL-ul de descărcare semnat.

Starea	Semnificație	Acțiune de client
`queued`	Admis în coada limitată.	Sondaj din nou cu backoff.
`extracting`	Reîmprospătarea metadatelor sursă sau a rutei.	Continuă să votezi.
`processing`	Descărcarea, remixarea sau îmbinarea.	Afișați progresul serverului.
`ready`	Descărcarea semnată este disponibilă.	Trimiteți URL-ul utilizatorului.
`failed`	Eroare structurată terminală.	Citiți `error_code`. Reîncercaţi numai atunci când este recomandat.
`expired`	Ieșirea temporară a fost eliminată.	Creați un loc de muncă nou.

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

Pentru interogarea Job, Insts verifică o așteptare inițială de o secundă înainte de un backoff plafonat. Acest banc de inspecție clarifică și livrarea temporară semnată.

Erori previzibile

Contractul de eroare începe cu un plic non-2xx pe Insts. Această bancă de inspecție prezintă apoi un ID de solicitare de asistență. Faptul final este manipularea previzibilă a clientului.

{
  "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	Semnificație tipică	Acțiune
400	URL nevalid, corp sau format indisponibil.	Corectați solicitarea. Rezolvați din nou pentru formate.
401	Cheie lipsă, nevalidă, expirată sau cu domeniu incorect.	Verificați acreditările de pe partea serverului.
403	Politica chiriașului sau a sursei a respins solicitarea.	Nu ocoliți politica. Contactați asistența.
404	Loc de muncă necunoscut sau expirat.	Creați un nou loc de muncă, dacă este cazul.
429	A fost atinsă limita de solicitări sau de lucrări active.	Onoare. `retry_after_seconds`.
503	Coada/capacitatea sau sursa din amonte sunt temporar indisponibile.	Reîncercați cu backoff exponențial și jitter.

Contract de exploatare

Insts stabilește limitele tarifare la momentul revizuirii pentru a proteja spațiul de lucru al inspecției și fiecare rută a furnizorului.

Folosiți logică de aplicație idempotentă și nu porniți niciodată joburi duplicate pentru același clic al utilizatorului.
Stocați temporar metadatele rezolvate în cache, dar tratați întotdeauna URL-urile semnate de descărcare ca expirabile.
Utilizați backoff exponențial limitat cu jitter pentru 429, 503 şi erori reîncercabile.
Procesează doar media publică sau media la care ești autorizat să ai acces. DRM și controalele de acces nu sunt ocolite.
Păstrați ID-urile cererilor și ID-urile joburilor în jurnalele operaționale private. Nu înregistrați inutil URL-urile trimise.

Accesul la schemă începe cu activarea înainte de explorare pe Insts. Următoarea vizualizare acoperă autentificarea atribuită. Pagina păstrează vizibile formele de solicitare documentate.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Împărtășiți cazul de utilizare al bancului de lucru, numărul estimat de apeluri și serviciile aflate în inspecție. Insts revizuiește acea limită înainte ca o acreditare a chiriașului să fie afișată o singură dată și redusă la un hash stocat.

Solicitați activarea Cheile sunt limitate la nivel de chiriaș, pot fi revocate și sunt emise prin formularul de contact. Scripturile anonime nu pot executa sarcini de descărcare.