Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset Insto: llä

Insto esittelee visuaalisen median integrointisuunnitelman arviointia varten. Reaaliaikainen analyysi ja työpyynnöt pysyvät käytettävissä vasta, kun tuki myöntää vuokrakohtaisen valtuutuksen.

InstoMediaJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

API-isännälle Insto alkaa käyttöön otetuilla tukitunnuksilla. Sen latausarvio yhdistää tämän määritettyyn tenantin päätepisteeseen ja päättyy palvelinpuolen kutsupolkuun.

Vuokraajan URL- osoitehttps://insto.app

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliInstoMedia

API-versiov1

# 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 esittelee kolme käytännöllistä kohtaa Credential-turvallisuudesta. Ensimmäisenä on palvelinpuolen salaisuuksien tallennus. Latauksen tarkistus käsittelee sitten sitä, ettei mitään upoteta asiakaspuolen bundleen. Sen viimeinen kohta on, ettei ole julkisia lokeja tai repositorioita.

Linkin ratkaiseminen

Resolve-toiminnossa Insto alkaa lähteen tunnistuksella. Sen latausarvio yhdistää tämän yhden lähetetyn URL-osoitteen formaatteihin ja päättyy ilman keksittyjä tuloksia.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`media_source`	HTTPS- URL	- Kyllä.	Julkinen tai valtuutettu mediapohja analysoitavaksi.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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

Insto esittää kolme käytännön kohtaa Formaatin tunnisteesta. Ensimmäisenä tulee palautettu arvo muuttumattomana. Latauksen tarkastelu käsittelee sitten linkkikohtaista saatavuutta. Sen viimeinen kohta on, ettei ole arvailtua laatumerkintää.

Luo ja seuraa lataustehtävää

Insto järjestää työhön luomisen ympärille asynkronisen valmistelun. Sen latauksen tarkistus vertaa lyhyttä HTTP-pyyntöä. Rajoitettu työntekijäsuoritus pysyy viimeisenä tarkistuksena.

POSTI/v1/jobsLaajuus: työpaikat

Kenttä	Tyyppi	Pakollinen	Kuvaus
`media_source`	HTTPS- URL	- Kyllä.	Sama normalisoitu lähde lähetetty ratkaistavaksi.
`media_variant`	merkkijono	- Kyllä.	Tarkka tunnus ratkaisuvasteesta.
`tenant`	merkkijono	Ei	Määrätty vuokralaisalue. Yleensä jätetään pois.

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 HyväksyttyTallenna prepare_id.

2Kyselyn tilaGET /v1/jobs/{prepare_id} samalla avaimella.

3Valmiina.Avaa allekirjoitettu lataus-URL.

Tila	Merkitys	Asiakastoiminta
`queued`	Pääsi rajattuun jonoon.	Kysely uudelleen takaisinvedolla.
`extracting`	Päivitetään lähdemetatietoja tai reittiä.	Jatka äänestystä.
`processing`	Ladataan, remuxataan tai yhdistetään.	Näytä palvelimen edistyminen.
`ready`	Allekirjoitettu lataus on saatavilla.	Lähetä URL-osoite käyttäjälle.
`failed`	Päätelaitteen rakenteellinen virhe.	Lue `error_code`Yritä uudelleen vain, kun sitä kehotetaan.
`expired`	Väliaikainen tuotos poistettiin.	Luo uusi työpaikka.

curl https://insto.app/v1/jobs/PREPARE_ID \
  -H "X-API-Key: $INSTO_MEDIA_TOKEN"

Insto:ssa yhden sekunnin alkuodotus tulee ensin, kun selitetään työn kyselyä. Tuo latauksen tarkistus seuraa sitten rajoitetulla takaisinkytkennällä ja päättyy tilapäiseen allekirjoitettuun toimitukseen.

Ennustettavat virheet

Selittääkseen Error contractin Insto erottaa yhden ei-2xx-ympäristön tukipyynnön tunnuksesta. Latauksen tarkastelu antaa ennustettavalle asiakaskäsittelylle oman paikkansa.

{
  "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	Tyypillinen merkitys	Toimi
400	Virheellinen URL-osoite, sisältö tai formaatti ei ole saatavilla.	Korjaa pyyntö. Ratkaise uudelleen formaateille.
401	Puuttuva, virheellinen, vanhentunut tai väärän laajuuden avain.	Tarkista palvelinpuolen tunnistetiedot.
403	Vuokralaisen tai lähdepolitiikan pyyntö hylättiin.	Älä ohita käytäntöä. Ota yhteyttä tukeen.
404	Tuntematon tai vanhentunut työpaikka.	Luo uusi tehtävä, jos tarpeen.
429	Pyyntö- tai aktiivisten tehtävien raja saavutettu.	Kunnia. `retry_after_seconds`.
503	Jono/kapasiteetti tai ylävirta tilapäisesti poissa käytöstä.	Yritä uudelleen eksponentiaalisella viiveellä ja häiriöllä.

Toiminnan sopimus

Insto räätälöi puhelurajoitukset visuaalisen median käyttötapaukseen ja verkkoihin, joihin hyväksytty asiakas ottaa yhteyttä.

Käytä idempotenttia sovelluslogiikkaa äläkä koskaan käynnistä päällekkäisiä tehtäviä saman käyttäjän klikkauksesta.
Välimuisti ratkaisee metatiedot lyhyesti, mutta käsittelee aina allekirjoitettuja lataus-URL-osoitteita vanhenevina.
Käytä rajattua eksponentiaalista takaisinkytkentää häiriöllä varten 429, 503 ja uudelleenyritettävä virheitä.
Käsittele vain julkista mediaa tai mediaa, johon sinulla on oikeus. DRM- ja käyttöoikeusrajoituksia ei kiertää.
Pidä pyyntö- ja työn tunnukset yksityisissä toimintalokeissa. Älä kirjaa lähetettyjä URL-osoitteita tarpeettomasti.

Schema-pääsyä varten Insto alkaa aktivoinnilla ennen tutkimista. Sen latausarvio yhdistää tämän määritettyyn tunnistautumiseen ja päättyy dokumentoituihin pyyntörakenteisiin.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Kuvaile visuaalisen median tuotetta, odotettua kuukausittaista käyttöä ja julkaisutyyppejä, joita aiot käsitellä. Insto myöntää vain tarvittavat analyysi- tai valmisteluoikeudet eikä koskaan tallenna luettavaa tunnistetta.

Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.