Alleen voorbeeld — activering vereist

Build downloads met Insts

De onderstaande Insts-werkbank is documentatie voor een potentiële klant. Beoordeling door een operator komt vóórdat er een uitvoerbare inloggegevens- of oproepmachtiging wordt aangemaakt.

InstsConnectVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

API-host begint met support-geactiveerde referenties op Insts. De volgende weergave behandelt een toegewezen tenant-eindpunt. De pagina houdt een alleen-server-aanroeppad zichtbaar.

URL van tenanthttps://insts.io

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantInstsConnect

API-versiev1

# 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 geheime opslag is het startpunt voor inloggegevensveiligheid op Insts. Een inspectiepunt laat vervolgens geen insluiting van clientbundels zien en verklaart dat er geen openbare logs of repositories zijn.

Een koppeling oplossen

De Resolve-bewerking begint met bronherkenning op Insts. Het volgende scherm behandelt formaten van één ingediende URL. De pagina houdt geen verzonnen uitvoer zichtbaar.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`shared_post`	HTTPS-URL	Ja.	Openbare of geautoriseerde mediapagina om te analyseren.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

De onveranderde geretourneerde waarde is het startpunt voor de formaataanduiding op Insts. Een inspectiebank presenteert vervolgens de beschikbaarheid per link en legt uit dat er geen geraadpleegd kwaliteitslabel is.

Maak en volg een downloadtaak

Insts maakt het eenvoudig om het aanmaken van een taak te scannen. De pagina begint met asynchrone voorbereiding, gaat over naar een kort HTTP-verzoek en vermeldt duidelijk de begrensde uitvoering door de worker.

POST/v1/jobsScope: vacatures

Veld	Type	Vereist	Beschrijving
`shared_post`	HTTPS-URL	Ja.	Dezelfde genormaliseerde bron ingediend om op te lossen.
`asset_option`	tekenreeks	Ja.	Een exacte ID uit de resolve-respons.
`tenant`	tekenreeks	Nee.	Toegewezen tenantdomein. Meestal weggelaten.

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

2Poll status 1GET /v1/jobs/{connect_job} met dezelfde sleutel.

3KlaarOpen de ondertekende download-URL.

Status	Betekenis	Actie van de klant
`queued`	Toegestaan in de beperkte wachtrij.	Poll weer met achteruit.
`extracting`	Bronmetadata of route vernieuwen.	Ga door met pollen.
`processing`	Bezig met downloaden, remuxen of samenvoegen.	Toon server voortgang.
`ready`	Ondertekende download is beschikbaar.	Stuur de URL naar de gebruiker.
`failed`	Terminal gestructureerde fout.	Lees `error_code`Probeer het alleen opnieuw als dat wordt geadviseerd.
`expired`	Tijdelijke uitvoer werd verwijderd.	Maak een nieuwe taak aan.

curl https://insts.io/v1/jobs/CONNECT_JOB \
  -H "X-API-Key: $INSTS_CONNECT_SECRET"

Voor Job polling controleert Insts één seconde initiële wachttijd vóór begrensde back-off. Deze inspectiebank maakt ook tijdelijke ondertekende levering duidelijk.

Voorspelbare fouten

De foutcontract begint met één niet-2xx-envelop op Insts. Deze inspectiebank toont vervolgens een ondersteuningsaanvraag-ID. Het laatste feit is voorspelbare clientafhandeling.

{
  "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	Typische betekenis	Actie
400	Ongeldige URL, body of niet beschikbare indeling.	Corrigeer de aanvraag. Los opnieuw op voor formaten.
401	Ontbrekende, ongeldige, verlopen of verkeerd bereik sleutel.	Controleer de serverzijde referentie.
403	Tenant of bronbeleid heeft de aanvraag afgewezen.	Omzeil het beleid niet. Neem contact op met de ondersteuning.
404	Onbekende of verlopen vacature.	Maak indien nodig een nieuwe taak aan.
429	Aanvraag- of actieve-taaklimiet bereikt.	Eer `retry_after_seconds`.
503	Wachtrij/capaciteit of upstream tijdelijk niet beschikbaar.	Probeer het opnieuw met exponentiële backoff en jitter.

Operationeel contract

Insts stelt tariefgrenzen vast op het moment van beoordeling om de inspectiewerkruimte en elke providerroute te beschermen.

Gebruik idempotente toepassingslogica en start nooit dubbele taken voor dezelfde gebruikersklik.
Cache lost metadata kort op, maar behandelt ondertekende download-URL's altijd als verlopen.
Gebruik begrensde exponentiële backoff met jitter voor 429, 503 en herprobeerbare fouten.
Verwerk alleen openbare media of media waarvoor u toegangsrechten hebt, en vermijd het omzeilen van DRM en toegangscontrole.
Bewaar verzoek-ID's en taak-ID's in privé-operationele logboeken. Log niet onnodig verzonden URL's.

Schema-toegang begint met activering vóór verkenning op Insts. Het volgende overzicht behandelt toegewezen authenticatie. De pagina houdt gedocumenteerde aanvraagvormen zichtbaar.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Deel de use-case van de werkbank, het geschatte aantal oproepen en de services die worden gecontroleerd. Insts beoordeelt die grens voordat een tenantreferentie één keer wordt weergegeven en wordt teruggebracht tot een opgeslagen hash.

Vraag activering aan Sleutels zijn tenant-gebonden, intrekbaar en worden uitgegeven via het contactformulier. Anonieme scripts kunnen geen downloadprogramma-taken uitvoeren.