Kun forhåndsvisning – aktivering kreves

Bygg nedlastinger med Insts

Insts-arbeidsbenken nedenfor er dokumentasjon for en potensiell klient. Operatørgjennomgang kommer før noen kjørbar legitimasjon eller anropsrettighet opprettes.

InstsConnectJSON over HTTPSAsynkrone jobberBrukerinformasjon med omfang

Rask start

API-vert starter med støtte-aktiverte legitimasjoner på Insts. Neste visning dekker et tildelt leietakerendepunkt. Siden holder en server-unik kallsti synlig.

Leietaker-URLhttps://insts.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilInstsConnect

API-versjonv1

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

Server-side hemmelig lagring er startpunktet for legitimasjonssikkerhet på Insts. En inspeksjonsbenk viser deretter ingen klientpakke-innbygging og forklarer ingen offentlige logger eller arkiver.

Løse en kobling

Løsningsoperasjonen starter med kildeoppdagelse på Insts. Neste visning dekker formater fra en innsendt URL. Siden viser ingen oppdiktede utdata.

POST/v1/resolveOmfang: løse

Felt	Type	Påkrevd	Beskrivelse
`shared_post`	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
}

Den returnerte verdien uendret er utgangspunktet for Formatidentifikator på Insts. En inspeksjonsbenk viser deretter tilgjengelighet per lenke og forklarer at det ikke finnes noen antatt kvalitetsmerkelapp.

Opprett og følg en nedlastingsjobb

Insts gjør jobbskaping lett å skanne. Siden starter med asynkron forberedelse, går videre til en kort HTTP-forespørsel, og angir tydelig avgrenset arbeidseksekvering.

POST/v1/jobsOmfang: jobber

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

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

2AvstemningsstatusGET /v1/jobs/{connect_job} 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://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

For jobbavstemning kontrollerer Insts ett sekunds innledende ventetid før avstengt tilbakeslag. Denne inspeksjonsbenken gjør også midlertidig signert levering tydelig.

Forutsigbare feil

Feilkontrakt begynner med ett ikke-2xx-konvolutt på Insts. Denne inspeksjonsbenken presenterer deretter en støtteforespørsels-ID. Det endelige faktum er forutsigbar klienthåndtering.

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

Insts etablerer hastighetsgrenser ved gjennomgangstidspunktet for å beskytte inspeksjonsarbeidsområdet og hver leverandørrute.

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.

Skjematilgang starter med aktivering før utforskning på Insts. Neste visning dekker tildelt autentisering. Siden holder dokumenterte forespørselsformer synlige.

TILGANG SOM OVERVÅKES AV OPERATOR

Aktiver gjennom støtte

Del bruksområdet for arbeidsbenken, estimert antall anrop og tjenester under inspeksjon. Insts vurderer den grensen før en leietakerlegitimasjon vises én gang og reduseres til en lagret hash.

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