Alleen voorbeeld — activering vereist

Bouw downloads met Insto

Insto presenteert een blauwdruk voor visuele media-integratie ter evaluatie. Live-analyse en taakverzoeken blijven onbeschikbaar totdat ondersteuning tenant-gescopeerde autorisatie verleent.

InstoMediaVerzenden van JSON over HTTPSAsynchrone jobsReferenties met bereik

Snel aan de slag

Voor API-host begint Insto met door ondersteuning geactiveerde referenties. De downloadbeoordeling koppelt dit aan een toegewezen tenant-eindpunt en eindigt met een server-only oproeppad.

URL van tenanthttps://insto.app

AuthenticatieX-API-Key: pending_activation_…

Profiel van de klantInstoMedia

API-versiev1

# 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 presenteert drie praktische punten voor credentialveiligheid. Eerst komt server-side geheime opslag. De downloadbeoordeling behandelt vervolgens geen client-bundel embedding. Het laatste punt is geen openbare logs of repositories.

Een koppeling oplossen

Voor Resolve-operatie begint Insto met bronherkenning. De downloadbeoordeling koppelt dit aan formaten van één ingediende URL en eindigt zonder verzonnen uitvoer.

POST/v1/resolveToepassingsgebied: oplossen

Veld	Type	Vereist	Beschrijving
`media_source`	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
}

Insto presenteert drie praktische punten voor Formaatidentificatie. Eerst komt de geretourneerde waarde ongewijzigd. De downloadbeoordeling behandelt vervolgens de beschikbaarheid per link. Het laatste punt is geen geraden kwaliteitslabel.

Maak en volg een downloadtaak

Insto organiseert taakcreatie rond asynchrone voorbereiding. De downloadbeoordeling vergelijkt een korte HTTP-aanvraag. Beperkte uitvoering van de worker blijft de laatste controle.

POST/v1/jobsScope: vacatures

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

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

2Poll status 1GET /v1/jobs/{prepare_id} 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://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

In Insto komt eerst een initiële wachttijd van één seconde bij het uitleggen van Job polling. Die downloadbeoordeling volgt met begrensde backoff en sluit af met tijdelijke ondertekende levering.

Voorspelbare fouten

Om de foutcontract uit te leggen, scheidt Insto een niet-2xx-bericht van een ondersteuningsverzoek-ID. Een downloadbeoordeling geeft voorspelbare clientafhandeling een eigen plaats.

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

Insto past oproeplimieten aan op de gebruikssituatie van visuele media en de netwerken waarmee de goedgekeurde client contact zal opnemen.

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.

Voor Schema-toegang begint Insto met activatie voordat verkenning plaatsvindt. De downloadbeoordeling koppelt dit aan toegewezen authenticatie en eindigt met gedocumenteerde aanvraagvormen.

DOOR DE OPERATOR BEHEERDE TOEGANG

Activeren via ondersteuning

Omschrijf het visuele mediaproduct, het verwachte maandelijkse gebruik en de berichttypen die je van plan bent te verwerken. Insto verleent alleen de noodzakelijke analysemogelijkheden of voorbereidingsscopes en slaat nooit het leesbare token op.

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