Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med Insto

Insto presenterar en blueprint för visuell medieintegration för utvärdering. Liveanalys och jobbförfrågningar förblir otillgängliga tills support beviljar hyresgäst-specifik auktorisering.

InstoMediaJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

För API-värd börjar Insto med supportaktiverade referenser. Dess nedladdningsgranskning parar ihop detta med en tilldelad hyresgäst-endpoint och avslutas med en serverendast anropsväg.

Webbadress till klienthttps://insto.app

AutentiseringX-API-Key: pending_activation_…

KlientprofilInstoMedia

API-versionv1

# 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 presenterar tre praktiska punkter för säkerhet av autentiseringsuppgifter. Först kommer serverbaserad hemlig lagring. Nedladdningsgranskningen täcker sedan ingen inbäddning av klientpaket. Dess sista punkt är inga offentliga loggar eller arkiv.

Lösa en länk

För Resolve-operationen börjar Insto med källdetektering. Dess nedladdningsgranskning parar ihop det med format från en inskickad URL och slutar utan påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`media_source`	HTTPS- URL	Ja	Offentlig eller auktoriserad mediesida att analysera.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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

Insto presenterar tre praktiska punkter för formatidentifierare. Först kommer det returnerade värdet oförändrat. Nedladdningsgranskningen täcker sedan tillgänglighet per länk. Dess sista punkt är ingen gissad kvalitetsmärkning.

Skapa och följ ett nedladdningsjobb

Insto organiserar jobbskapande kring asynkron förberedelse. Dess nedladdningsgranskning jämför en kort HTTP-förfrågan. Begränsad arbetarexekvering förblir den slutgiltiga kontrollen.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`media_source`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`media_variant`	sträng	Ja	Ett exakt ID från lösningssvaret.
`tenant`	sträng	Nej	Tilldelad hyresgästdomän. Vanligtvis utelämnad.

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 GodkändSpara prepare_id.

2OmröstningsstatusGET /v1/jobs/{prepare_id} med samma nyckel.

3KlarÖppna den signerade nedladdnings-URL:en.

Status	Betydelse	Klientåtgärd
`queued`	Antagen till den begränsade kön.	Rösta igen med fördröjning.
`extracting`	Uppdaterar källmetadata eller rutt.	Fortsätt med omröstningen.
`processing`	Laddar ner, remuxar eller slår ihop.	Visa serverns framsteg.
`ready`	Signerad nedladdning är tillgänglig.	Skicka URL:en till användaren.
`failed`	Terminal strukturerat fel.	Läs `error_code`. Försök igen endast när det rekommenderas.
`expired`	Tillfällig utdata togs bort.	Skapa ett nytt jobb.

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

I Insto kommer en sekunds initial väntan först när Jobb-polling förklaras. Den nedladdningsgranskningen följs av begränsad backoff och avslutas med tillfällig signerad leverans.

Förutsägbara fel

För att förklara Felkontrakt, skiljer Insto ett icke-2xx kuvert från en supportförfrågnings-ID. En nedladdningsgranskning ger förutsägbar klienthantering sin egen plats.

{
  "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 betydelse	Åtgärd
400	Ogiltig URL, innehåll eller otillgängligt format.	Korrigera förfrågan. Lös igen för format.
401	Saknad, ogiltig, utgången eller felaktig nyckel med fel behörighet.	Kontrollera serverns autentiseringsuppgifter.
403	Hyresgäst- eller källpolicy avvisade förfrågan.	Bryt inte mot policyn. Kontakta support.
404	Okänt eller utgånget jobb.	Skapa ett nytt jobb om det är lämpligt.
429	Begäran eller aktivt jobbgräns uppnådd.	Heder `retry_after_seconds`.
503	Kö/kapacitet eller upstream tillfälligt otillgänglig.	Försök igen med exponentiell backoff och jitter.

Driftkontrakt

Insto skräddarsyr samtalsgränser till användningsfallet för visuella medier och de nätverk som den godkända klienten kommer att kontakta.

Använd idempotent programlogik och starta aldrig dubbla jobb för samma användarklick.
Cache lösa metadata kort, men alltid behandla signerade nedladdning webbadresser som löper ut.
Använd begränsad exponentiell backoff med jitter för 429, 503 och omförsökbara fel.
Bearbeta endast offentliga medier eller medier som du har behörighet att komma åt. DRM och åtkomstkontroller kringgås inte.
Spara begäran-ID och jobb-ID i privata driftloggar. Logga inte inskickade webbadresser i onödan.

För Schema-åtkomst börjar Insto med aktivering innan utforskning. Dess nedladdningsgranskning kombinerar detta med tilldelad autentisering och avslutas med dokumenterade förfrågningsformat.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Beskriv den visuella medieprodukten, förväntad månatlig användning och inläggstyper du planerar att hantera. Insto ger endast nödvändiga analys- eller förberedelseomfång och lagrar aldrig den läsbara token.

Begär aktivering av konto Nycklar är klientomfattande, återkalleliga och utfärdas via Kontaktformuläret. Anonyma skript kan inte utföra hämtningsarbete.