Esikatselu vain — aktivointi vaaditaan

Rakenna lataukset Insts: llä

Alla oleva Insts-työpöytä on dokumentaatiota mahdolliselle asiakkaalle. Operaattorin tarkistus tehdään ennen kuin mitään suoritettavaa tunnistetietoa tai puheluoikeutta luodaan.

InstsConnectJSON HTTPS:n kauttaAsynkroniset työtLaajennetut tunnistetiedot

Pika-aloitus

API-isäntä alkaa tuetuilla käyttöön otetuilla tunnistetiedoilla kohdassa Insts. Seuraava näkymä kattaa määritetyn vuokralaispäätepisteen. Sivulla pidetään palvelinpuolen kutsupolku näkyvissä.

Vuokraajan URL- osoitehttps://insts.io

TodentaminenX-API-Key: pending_activation_…

AsiakasprofiiliInstsConnect

API-versiov1

# 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"}'

Palvelinpuolen salaisen tiedon tallennus on lähtökohta Credential-turvallisuudelle Insts:ssa. Tarkastusasema puolestaan osoittaa, ettei asiakaspuolen pakettia upoteta, eikä julkisia lokeja tai repositorioita ole.

Linkin ratkaiseminen

Ratkaisutoiminto alkaa lähteen tunnistuksella kohteessa Insts. Seuraava näkymä kattaa yhdestä lähetetystä URL-osoitteesta saatavat muodot. Sivulla ei pidetä näkyvissä keksittyjä tuloksia.

POSTI/v1/resolveLaajuus: ratkaista

Kenttä	Tyyppi	Pakollinen	Kuvaus
`shared_post`	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
}

Palautettu arvo muuttumattomana on lähtökohta Format identifierille Insts:ssa. Tarkastuspöytä esittää sitten linkkikohtaisen saatavuuden ja selittää, ettei ole arvattua laatumerkintää.

Luo ja seuraa lataustehtävää

Insts tekee työn luomisesta helppolukuista. Sivu alkaa asynkronisella valmistelulla, siirtyy lyhyeen HTTP-pyyntöön ja kertoo selkeästi rajatun työntekijäsuorituksen.

POSTI/v1/jobsLaajuus: työpaikat

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

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

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

Job pollingissa Insts tarkistaa yhden sekunnin alkuodotuksen ennen katkaistua takaisinottoa. Tämä tarkastuspöytä myös tekee väliaikaisen allekirjoitetun toimituksen selväksi.

Ennustettavat virheet

Virhesopimus alkaa yhdellä muulla kuin 2xx-kääreellä Insts:ssa. Tämä tarkastuspiste esittää sitten tukipyynnön tunnuksen. Viimeinen fakta on ennustettava asiakaskäsittely.

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

Insts määrittää nopeuden rajat tarkistushetkellä suojaamaan tarkastustyötilaa ja jokaista palveluntarjoajan reittiä.

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.

Skeeman käyttö alkaa aktivoinnilla ennen tutkimista Insts:ssä. Seuraava näkymä kattaa määritetyn todentamisen. Sivu pitää dokumentoidut pyyntörakenteet näkyvissä.

TOIMIJAN TARKASTAMALLA PÄÄSY

Aktivoi tuen kautta

Jaa työpöydän käyttötapaus, arvioitu kutsumäärä ja tarkastuksessa olevat palvelut. Insts tarkistaa tuon rajan ennen kuin vuokralaisen tunnus näytetään kerran ja muutetaan tallennetuksi hashiksi.

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