Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med Insto

Insto presenterer en plan for integrasjon av visuelle medier for evaluering. Direkte analyse og jobbforespørsler er utilgjengelige til support gir tenant-avgrenset autorisasjon.

InstoMediaJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

For API-vert begynner Insto med støtteaktiverte legitimasjoner. Nedlastingsgjennomgangen kombinerer dette med et tildelt leietakerendepunkt og avsluttes med en serveronly kallbane.

Leietaker-URLhttps://insto.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilInstoMedia

API-versjonv1

# 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 presenterer tre praktiske punkter for sikkerhet ved legitimasjon. Først kommer serverbasert hemmelig lagring. Nedlastingsgjennomgangen dekker deretter ingen innebygging i klientpakken. Det siste punktet er ingen offentlige logger eller repositorier.

Løse en kobling

For Resolve-operasjonen begynner Insto med kildedeteksjon. Nedlastingsgjennomgangen kobler dette med formater fra én innsendt URL og avsluttes uten oppdiktede utdata.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`media_source`	HTTPS-URL	Ja	Offentlig eller autorisert medieside å analysere.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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

Insto presenterer tre praktiske punkter for formatidentifikator. Først kommer den returnerte verdien uendret. Nedlastingsgjennomgangen dekker deretter tilgjengelighet per lenke. Det siste punktet er at det ikke finnes noen gjetta kvalitetsmerking.

Opprett og følg en nedlastingsjobb

Insto organiserer opprettelse av jobber rundt asynkron forberedelse. Dens nedlastingsgjennomgang sammenligner en kort HTTP-forespørsel. Begrenset utførelse av arbeidere forblir den siste kontrollen.

POST/v1/jobsOmfang: jobber

Felt	Type	Påkrevd	Beskrivelse
`media_source`	HTTPS-URL	Ja	Den samme normaliserte kilden innlevert for å løse.
`media_variant`	streng	Ja	En nøyaktig ID fra løsningssvaret.
`tenant`	streng	Nei	Tilordnet leierdomene. Vanligvis utelatt.

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 AkseptertLagre@ action: button prepare_id.

2AvstemningsstatusGET /v1/jobs/{prepare_id} med samme nøkkel.

3KlarÅpne den signerte nedlastingsadressen.

Status	Betydning	Klienthandling
`queued`	Opptatt i den begrensede køen.	Avstemning igjen med baklengs.
`extracting`	Oppdaterer kildemetadata eller rute.	Fortsett å avstemme.
`processing`	Laster ned, remikser eller slår sammen.	Vis server fremgang.
`ready`	Signert nedlasting er tilgjengelig.	Send URL-adressen til brukeren.
`failed`	Terminalstrukturert feil.	Lest `error_code`Prøv på nytt bare når det anbefales.
`expired`	Midlertidig utgang ble fjernet.	Opprett en ny jobb.

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

I Insto kommer en innledende ventetid på ett sekund først når Job-polling forklares. Den nedlastingsgjennomgangen følger med begrenset tilbakeoff og avsluttes ved midlertidig signert levering.

Forutsigbare feil

For å forklare feilkontrakten skiller Insto én ikke-2xx-innpakning fra en støtteforespørsels-ID. En nedlastingsgjennomgang gir forutsigbar klienthåndtering sin egen plass.

{
  "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	Typisk betydning	Handling
400	Ugyldig URL, brødtekst eller utilgjengelig format.	Rett opp forespørselen. Løs igjen for formater.
401	Manglende, ugyldig, utløpt eller feil omfang nøkkel.	Sjekk server-side legitimasjon.
403	Leietaker eller kildepolicy avslo forespørselen.	Ikke omgå policyen. Kontakt kundestøtte.
404	Ukjent eller utløpt jobb.	Opprett en ny jobb om det er passende.
429	Grensen for forespørsler eller aktive jobber er nådd.	Ære `retry_after_seconds`.
503	Kø/kapasitet eller oppstrøms midlertidig utilgjengelig.	Prøv igjen med eksponentiell tilbakeslag og jitter.

Driftskontrakt

Insto tilpasser anropsgrenser til brukstilfellet for visuelt medieinnhold og nettverkene den godkjente klienten vil kontakte.

Bruk idempotent programlogikk og aldri starte dupliserte jobber for samme bruker klikk.
Cache løse metadata kort, men alltid behandle signerte nedlastingsadresser som utløper.
Bruk begrenset eksponentiell tilbakeslag med jitter for 429, 503 og gjentatte feil.
Behandle bare offentlige medier eller medier du har autorisert tilgang til. DRM og tilgangskontroller omgås ikke.
Oppbevar forespørsels-ID-er og jobb-ID-er i private driftslogger. Ikke logg innsendte URL-er unødvendig.

For Schema-tilgang begynner Insto med aktivering før utforskning. Nedlastingsgjennomgangen kobler det sammen med tildelt autentisering og avsluttes med dokumenterte forespørselsformater.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Skisser produktet for visuelt media, forventet månedlig bruk og hvilke innholdstyper du planlegger å håndtere. Insto gir bare de nødvendige analyse- eller forberedelsesområdene og lagrer aldri den lesbare tokenen.

Be om aktivering Nøklene er basert på leietakers omfang, kan tilbakekalles og utstedes via Kontaktskjemaet.