Kun prøveversion — aktivering kræves

Byg downloads med Insto

Insto Liveanalyse og jobanmodninger er ikke tilgængelige, før supporten giver tilladelse til at bruge funktionen i henhold til lejemålets omfang.

InstoMediaJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

For API-vært starter Insto med supportaktiverede legitimationsoplysninger, som downloadgennemgangen parrer med et tildelt lejer-slutpunkt, og slutter med en opkaldssti, der kun er for serveren.

Lejer- URLhttps://insto.app

GodkendelseX-API-Key: pending_activation_…

Profil af klientInstoMedia

Version af 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 præsenterer tre praktiske punkter for legitimationssikkerhed. Først kommer server-side hemmelig opbevaring. Downloadgennemgangen dækker derefter ingen klientpakkeindlejring. Det sidste punkt er ingen offentlige logfiler eller arkiver.

Løsning af et link

For Resolve-operationen begynder Insto med kildeidentifikation. Dens downloadanmeldelse parrer det med formater fra en indsendt URL og slutter uden opfundne output.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrævet	Beskrivelse
`media_source`	HTTPS- URL	Ja	Offentlig eller autoriseret medieside at analysere.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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

Insto præsenterer tre praktiske punkter for formatidentifikator. Først kommer den returnerede værdi uændret. Downloadanmeldelsen dækker derefter tilgængelighed pr. link. Det sidste punkt er ingen gættet kvalitetsmærkat.

Opret og følg et downloadjob

Insto organiserer oprettelse af job omkring asynkron forberedelse. Dens download-gennemgang sammenligner en kort HTTP-anmodning. Bounded worker udførelse forbliver den endelige kontrol.

POST/v1/jobsOmfang: job

Felt	Type	Påkrævet	Beskrivelse
`media_source`	HTTPS- URL	Ja	Den samme normaliserede kilde indsendt til at løse.
`media_variant`	streng	Ja	Et nøjagtigt id fra forklaringssvaret.
`tenant`	streng	Nej	Tildelt lejerdomæne. Udelades normalt.

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 AccepteretGem prepare_id.

2AfstemningsstatusGET /v1/jobs/{prepare_id} med samme nøgle.

3KlarÅbn den signerede download-URL.

Status	Betydning	Klienthandling
`queued`	Optaget i den afgrænsede kø.	Afstemning igen med tilbageslag.
`extracting`	Opdatering af kildemetadata eller rute.	Fortsæt med at stemme.
`processing`	Downloading, remuxing eller sammenlægning.	Vis server fremskridt.
`ready`	Signeret download er tilgængelig.	Send URL-adressen til brugeren.
`failed`	Terminal struktureret fejl.	Læs `error_code`. Prøv kun igen, når det anbefales.
`expired`	Midlertidig output blev fjernet.	Opret et nyt job.

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

I Insto kommer en indledende ventetid på ét sekund først, når der forklares om jobafstemning. Denne downloadgennemgang følger med begrænset tilbageholdelse og lukkes ved midlertidig underskrevet levering.

Forudsigelige fejl

For at forklare Fejlkontakt adskiller Insto en ikke-2xx konvolut fra en supportanmodnings-ID. En download-gennemgang giver forudsigelig klienthåndtering sin egen plads.

{
  "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 utilgængeligt format.	Ret anmodningen. Prøv igen for formater.
401	Manglende, ugyldig, udløbet eller forkert områdenøgle.	Kontroller legitimationsoplysningerne på serversiden.
403	Lejer- eller kildepolitikken afviste anmodningen.	Omgå ikke politikken. Kontakt support.
404	Ukendt eller udløbet job.	Opret eventuelt et nyt job.
429	Grænsen for anmodninger eller aktive job er nået.	Ære `retry_after_seconds`.
503	Kø/kapacitet eller opstrøm midlertidigt utilgængelig.	Prøv igen med eksponentiel tilbagefald og jitter.

Driftskontrakt

Insto skræddersyr opkaldsgrænser til brugssagen for visuelle medier og de netværk, som den godkendte klient vil kontakte.

Brug idempotent programlogik, og start aldrig dublerede job for det samme brugerklik.
Cache løse metadata kortvarigt, men altid behandle underskrevne download URL'er som udløber.
Brug begrænset eksponentiel tilbagetrækning med jitter for 429, 503 og genforsøgbare fejl.
Behandl kun offentlige medier eller medier, du har tilladelse til at få adgang til. DRM og adgangskontroller omgås ikke.
Behold anmodnings-ID'er og job-ID'er i private driftslogfiler. Log ikke indsendte URL'er unødvendigt.

For Schema-adgang begynder Insto med aktivering før udforskning. Dens download-gennemgang parrer det med tildelt godkendelse og slutter med dokumenterede anmodningsformer.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Skitsér det visuelle medieprodukt, forventet månedligt forbrug og indlægstyper, du planlægger at håndtere. Insto giver kun de nødvendige analyse- eller forberedelsesområder og gemmer aldrig den læsbare token.

Anmod om aktivering Nøgler er lejerafgrænsede, kan tilbagekaldes og udstedes via kontaktformularen. Anonyme scripts kan ikke udføre downloaderarbejde.