https://easyt.ioRakenna lataukset EasyT: llä
Tämä EasyT-viite on toteutusopas eikä aktiivinen anonyymi päätepiste. Tuotantokäyttö alkaa vasta, kun tuki on hyväksynyt asiakkaan ja määrittänyt rajoitukset.
Pika-aloitus
API-isäntä alkaa tuetulla käyttöön otetuilla tunnistetiedoilla EasyT:ssa. Tämä ohjattu tarkistus esittää sitten määritetyn vuokralaispäätepisteen. Viimeinen tieto on palvelinpuolen kutsupolku.
X-API-Key: pending_activation_…EasytWorkspacev1# Available only after support activation
export EASYT_WORKSPACE_TOKEN="issued-after-review"
curl -X POST https://easyt.io/v1/resolve \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'EasyT:ssa palvelinpuolen salaisen tiedon tallennus on etusijalla, kun selitetään tunnistetietojen turvallisuutta. Tätä ohjaavaa tarkistusta seuraa, ettei asiakaspuolen pakettiin upoteta mitään, ja se päättyy siihen, ettei tietoja ole julkisissa lokeissa tai repositorioissa.
Linkin ratkaiseminen
Resolve-toiminto alkaa lähteen tunnistuksella EasyT:ssa. Tämä ohjattu tarkistus esittää sitten muodot yhdestä lähetetystä URL-osoitteesta. Lopullinen tosiasia on, ettei keksittyjä tuloksia ole.
/v1/resolveLaajuus: ratkaista| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
input_url | 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
}EasyT:ssa palautettu muuttumaton arvo tulee ensin, kun selitetään formaatin tunnistetta. Tätä ohjaavaa tarkistusta seuraa linkkikohtainen saatavuus, ja se päättyy ilman arvailtua laatumerkintää.
Luo ja seuraa lataustehtävää
Asynkroninen valmistelu on työn luomisen lähtökohta EasyT:ssä. Ohjattu tarkistus esittää sitten lyhyen HTTP-pyynnön ja selittää rajatun työntekijäsuorituksen.
/v1/jobsLaajuus: työpaikat| Kenttä | Tyyppi | Pakollinen | Kuvaus |
|---|---|---|---|
input_url | HTTPS- URL | - Kyllä. | Sama normalisoitu lähde lähetetty ratkaistavaksi. |
stream_choice | merkkijono | - Kyllä. | Tarkka tunnus ratkaisuvasteesta. |
tenant | merkkijono | Ei | Määrätty vuokralaisalue. Yleensä jätetään pois. |
curl -X POST https://easyt.io/v1/jobs \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN" \
-H "Content-Type: application/json" \
-d '{"input_url":"https://www.youtube.com/watch?v=VIDEO_ID","stream_choice":"18"}'workspace_job.GET /v1/jobs/{workspace_job} samalla avaimella.| 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_codeYritä uudelleen vain, kun sitä kehotetaan. |
expired | Väliaikainen tuotos poistettiin. | Luo uusi työpaikka. |
curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
-H "X-API-Key: $EASYT_WORKSPACE_TOKEN"Työtehtävien pollingissa EasyT alkaa yhden sekunnin alkoviiveellä. Sen ohjattu tarkistus yhdistää sen rajoitettuun takaisinkytkentään ja päättyy tilapäiseen allekirjoitettuun toimitukseen.
Ennustettavat virheet
EasyT tekee Error-sopimuksesta helpon skannata. Sivulla alkaa yhdellä muulla kuin 2xx-kuorella, siirrytään tukipyyntö-ID:hen ja kerrotaan selvästi 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
EasyT valitsee käyttöoikeuden tarkastelun aikana, tasapainottaen sovelluksen tarpeet ja palveluntarjoajan terveyden.
- 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,503ja 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 EasyT:ssä. Tämä ohjattu tarkistus esittää sitten määritetyn todennuksen. Lopullinen tosiasia on dokumentoidut pyyntörakenteet.
Aktivoi tuen kautta
Sisällytä aktivointimuistioon asiakkaan tarkoitus, odotettu kuukausittainen työmäärä ja pyydetyt verkot. EasyT voi sen jälkeen valita ratkaisu- ja työtehtävälaajuudet oikein ennen yhden näkymän salaisuuden tuottamista.
Pyydä aktivointia Avain on vuokralaiskohtainen, peruutettavissa ja myönnetään Yhteydenottolomakkeen kautta. Anonyymit skriptit eivät voi suorittaa lataustyötä.