Kun prøveversion — aktivering kræves

Byg downloads med Insts

Insts-arbejdsbordet nedenfor er dokumentation til en potentiel klient. Operatørgennemgang kommer før enhver eksekverbar legitimationsoplysning eller opkaldstilladelse oprettes.

InstsConnectJSON over HTTPSAsynkrone jobLegitimationsoplysninger med anvendelsesområde

Hurtig start

API-værten starter med support-aktiverede legitimationsoplysninger på Insts. Det næste visning dækker en tildelt lejer-endpoint. Siden holder en server-only opkaldssti synlig.

Lejer- URLhttps://insts.io

GodkendelseX-API-Key: pending_activation_…

Profil af klientInstsConnect

Version af APIv1

# 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 hemmelagring er udgangspunktet for legitimationssikkerhed på Insts. En inspektionsbænk præsenterer derefter ingen klientpakkeindlejring og forklarer ingen offentlige logfiler eller arkiver.

Løsning af et link

Opløsningsoperationen starter med kildeidentifikation på Insts. Det næste visning dækker formater fra en indsendt URL. Siden holder ingen opfundne output synlige.

POST/v1/resolveOmfang: løse

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

Den returnerede værdi uændret er udgangspunktet for Format identifikator på Insts. En inspektionsbænk præsenterer derefter per-link tilgængelighed og forklarer ingen gættet kvalitetsmærke.

Opret og følg et downloadjob

Insts gør Joboprettelse nem at scanne. Siden starter med asynkron forberedelse, går videre til en kort HTTP-anmodning, og angiver klart begrænset arbejderudførelse.

POST/v1/jobsOmfang: job

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

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

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

For Job-afstemning tjekker Insts et ét-sekunds initialt ventetid før begrænset tilbagefald. Denne inspektionsbænk gør også midlertidig signeret levering klar.

Forudsigelige fejl

Fejlaftale begynder med en ikke-2xx konvolut på Insts. Denne inspektionsbænk præsenterer derefter en supportanmodnings-ID. Det endelige faktum er forudsigelig 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 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

Insts fastsætter takstgrænser ved gennemgangstidspunktet for at beskytte inspektionsarbejdsområdet og hver udbyderrute.

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.

Skemaadgang starter med aktivering før udforskning på Insts. Det næste visning dækker tildelt autentificering. Siden holder dokumenterede anmodningsformer synlige.

OPERATØRGENNEMGÅET ADGANG

Aktivér gennem støtte

Del brugssagen for arbejdsbordet, estimeret antal opkald og tjenester under inspektion. Insts gennemgår den grænse, før en lejertilladelse vises én gang og reduceres til en lagret hash.

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