Numai previzualizare — activare necesară

Construiți descărcări cu Insto

Insto prezintă un plan de integrare media vizuală pentru evaluare. Analiza în timp real și solicitările de job rămân indisponibile până când asistența acordă autorizarea la nivel de tenant.

InstoMediaJSON prin HTTPSLocuri de muncă asincroneAcreditări cu domeniu

Start rapid

Pentru gazda API, Insto începe cu acreditări activate de suport. Revizuirea descărcării asociază acestea cu un punct final de tenant atribuit și se încheie cu o cale de apel doar pentru server.

URL- ul entității găzduitehttps://insto.app

AutentificareX-API-Key: pending_activation_…

Profilul de clientInstoMedia

Versiune 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 prezintă trei puncte practice pentru siguranța acreditărilor. Primul este stocarea secretelor pe server. Analiza descărcării acoperă apoi lipsa încorporării în pachetul client. Ultimul său punct este absența jurnalelor publice sau a depozitelor.

Rezolvarea unui link

Pentru operațiunea Resolve, Insto începe cu detectarea sursei. Revizuirea descărcării îl asociază cu formatele dintr-un URL trimis și se încheie fără rezultate inventate.

POST/v1/resolveScop: rezolva

Câmp	Tip	Obligatoriu	Descrierea
`media_source`	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
}

Insto prezintă trei puncte practice pentru identificatorul de format. Mai întâi apare valoarea returnată neschimbată. Apoi, recenzia de descărcare acoperă disponibilitatea pentru fiecare link. Ultimul său punct este că nu există nicio etichetă de calitate presupusă.

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

Insto organizează crearea Joburilor în jurul pregătirii asincrone. Revizuirea descărcării sale compară o solicitare HTTP scurtă. Execuția delimitată a workerului rămâne verificarea finală.

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

Câmp	Tip	Obligatoriu	Descrierea
`media_source`	URL HTTPS	Da.	Aceeași sursă normalizată prezentată pentru a rezolva.
`media_variant`	ș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://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 AcceptatSalvează prepare_id.

2Starea sondajuluiGET /v1/jobs/{prepare_id} 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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

În Insto, așteptarea inițială de o secundă vine prima atunci când se explică interogarea Job. Acea revizuire a descărcării urmează cu backoff plafonat și se încheie la livrarea temporară semnată.

Erori previzibile

Pentru a explica contractul de eroare, Insto separă un plic non-2xx de un ID de solicitare către suport. O recenzie a descărcării oferă o gestionare previzibilă de către client propriul său loc.

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

Insto adaptează limitele de apel pentru cazul de utilizare media vizuală și pentru rețelele pe care clientul aprobat le va contacta.

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.

Pentru accesul la Schema, Insto începe cu activarea înainte de explorare. Recenzia sa de descărcare asociază acest lucru cu autentificarea atribuită și se încheie cu forme de solicitare documentate.

ACCES REVIZUIT DE OPERATOR

Activați prin asistență

Prezentați produsul media vizuală, utilizarea lunară estimată și tipurile de postări pe care intenționați să le gestionați. Insto acordă doar domeniile de analiză sau pregătire necesare și nu stochează niciodată tokenul lizibil.

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.