Endast förhandsgranskning — aktivering krävs

Bygg nedladdningar med Insts

Insts-arbetsbänken nedan är dokumentation för en potentiell klient. Operatörsgranskning sker innan några körbara behörigheter eller samtalstillstånd skapas.

InstsConnectJSON över HTTPSAsynkrona jobbAutentiseringsuppgifter med omfattning

Snabbstart för Windows

API-värd startar med supportaktiverade referenser på Insts. Nästa vy täcker en tilldelad hyresgästandpunkt. Sidan håller en serverendast samtalsväg synlig.

Webbadress till klienthttps://insts.io

AutentiseringX-API-Key: pending_activation_…

KlientprofilInstsConnect

API-versionv1

# 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-sidig hemlig lagring är startpunkten för autentiseringssäkerhet på Insts. En inspektionsbänk visar då ingen klientpaketbäddning och förklarar inga offentliga loggar eller arkiv.

Lösa en länk

Upplösningsoperationen börjar med källidentifiering på Insts. Nästa vy täcker format från en inskickad URL. Sidan visar inga påhittade utdata.

POST/v1/resolveOmfattning: lösa

Fält	Typ	Obligatoriskt	Beskrivning
`shared_post`	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
}

Det returnerade värdet oförändrat är startpunkten för formatidentifieraren på Insts. En inspektionsbänk visar sedan tillgänglighet per länk och förklarar att ingen gissad kvalitetsmärkning finns.

Skapa och följ ett nedladdningsjobb

Insts gör Jobbskapande lätt att skanna. Sidan börjar med asynkron förberedelse, går vidare till en kort HTTP-förfrågan och anger tydligt begränsad arbetarexekvering.

POST/v1/jobsOmfattning: jobb

Fält	Typ	Obligatoriskt	Beskrivning
`shared_post`	HTTPS- URL	Ja	Samma normaliserade källa skickades in för att lösa.
`asset_option`	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://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 GodkändSpara connect_job.

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

För jobbavstämning kontrollerar Insts en initial väntetid på en sekund innan begränsad återgång. Denna inspektionsbänk gör också temporär signerad leverans tydlig.

Förutsägbara fel

Felkontrakt börjar med ett icke-2xx kuvert på Insts. Denna inspektionsbänk presenterar sedan ett supportförfrågnings-ID. Den slutgiltiga faktan är förutsägbar klienthantering.

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

Insts upprättar hastighetsgränser vid granskningstidpunkten för att skydda inspektionsarbetsytan och varje leverantörsväg.

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.

Schemaåtkomst börjar med aktivering innan utforskning på Insts. Nästa vy täcker tilldelad autentisering. Sidan håller dokumenterade förfrågningsformer synliga.

OPERATÖRSGRANSKAD ÅTKOMST

Aktivera via support

Dela användningsfallet för arbetsbänken, uppskattat antal samtal och tjänster under granskning. Insts granskar den gränsen innan en hyresgästs referens visas en gång och reduceras till en lagrad hash.

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