Samo predogled – zahteva se aktivacija

Graditi prenose z EasyT

Ta referenca EasyT je vodnik za implementacijo in ne aktivna anonimna točka. Dostop do produkcije se začne šele po odobritvi stranke s strani podpore in dodelitvi omejitev.

EasytWorkspaceJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

Gostitelj API se začne z poverilnicami, aktiviranimi s podporo na EasyT. Ta vodeni pregled nato prikaže dodeljeno končno točko najemnika. Končni podatek je pot klicev samo za strežnik.

URL najemnikahttps://easyt.io

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaEasytWorkspace

Različica API-jav1

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

V EasyT je strežniško skrivno shranjevanje na prvem mestu pri razlagi varnosti poverilnic. Ta vodena kontrola sledi brez vdelave odjemalskega paketa in se zaključi brez javnih dnevnikov ali repozitorijev.

Reši povezavo

Postopek reševanja se začne z zaznavanjem vira na EasyT. Ta vodeni pregled nato prikaže formate iz enega poslanega URL-ja. Končni podatek je, da ni izmišljenih izhodov.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`input_url`	HTTPS URL	Da.	Javna ali pooblaščena medijska stran za analizo.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

V EasyT se pri razlagi identifikatorja formata najprej vrne nespremenjena vrednost. Ta vodeni pregled sledi z razpoložljivostjo na povezavo in se zaključi brez domnevne oznake kakovosti.

Ustvarjanje in spremljanje opravila prenosa

Asinhrona priprava je izhodišče za ustvarjanje opravila na EasyT. Nato vodeni pregled prikaže kratek HTTP zahtevek in pojasni omejeno izvajanje delavca.

POST/v1/jobsObseg: delovna mesta

Polje	Vrsta	Zahtevano	Opis
`input_url`	HTTPS URL	Da.	Isti normalizirani vir je bil poslan za rešitev.
`stream_choice`	niz	Da.	Natančna ID iz odziva reševanja.
`tenant`	niz	Ne.	Dodeljena domena najemnika. Običajno izpuščeno.

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

1202 SprejetoShrani workspace_job.

2Stanje anketeGET /v1/jobs/{workspace_job} z istim ključem.

3PripravljenOdprite podpisan URL za prenos.

Stanje	Pomen	Dejanje stranke
`queued`	Sprejeto v omejeno čakalno vrsto.	Anketa znova z backoff.
`extracting`	Osveževanje metapodatkov vira ali poti.	Nadaljujte z glasovanjem.
`processing`	Prenos, remuxing ali združevanje.	Prikaz napredka strežnika.
`ready`	Podpisan prenos je na voljo.	Pošljite URL uporabniku.
`failed`	Napaka strukture terminala.	Preberi `error_code`Ponovite le, ko vam svetujemo.
`expired`	Začasni izhod je bil odstranjen.	Ustvarite novo delovno mesto.

curl https://easyt.io/v1/jobs/WORKSPACE_JOB \
  -H "X-API-Key: $EASYT_WORKSPACE_TOKEN"

Za anketiranje opravila se EasyT začne z enosekundno začetno čakalno dobo, ki jo vodeno preverjanje seznani z omejenim zamikom in konča z začasno podpisano dostavo.

Predvidljive napake

EasyT omogoča enostavno pregledovanje pogodbe o napaki. Stran se začne z enim ne-2xx ovojem, nadaljuje z ID-jem zahteve za podporo in jasno navaja predvideno ravnanje s stranko.

{
  "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	Tipičen pomen	Ukrepanje
400	Neveljaven URL, telo ali nedosegljiv format.	Popravite zahtevo. Ponovno rešite za formate.
401	Manjkajoč, neveljaven, potekel ali napačnega obsega ključ.	Preverite poverilnice na strani strežnika.
403	Najemnik ali izvorna politika sta zavrnila zahtevo.	Ne zaobidite politike. Kontaktirajte podporo.
404	Neznano ali poteklo delovno mesto.	Po potrebi ustvarite novo delovno mesto.
429	Dosežena omejitev zahtev ali aktivnih opravil.	Čast. `retry_after_seconds`.
503	Čakalna vrsta/zmogljivost ali zgornji tok začasno ni na voljo.	Poskusite znova z eksponentnim zamikom in naključnim odmikom.

Pogodba o obratovanju

EasyT med pregledom izbere operativni dodatek, ki uravnoteži potrebe aplikacije z zdravjem ponudnika.

Uporabite idempotentno logiko aplikacije in nikoli ne zaženite podvojenih opravil za isti klik uporabnika.
Predpomnite metapodatke reševanja na kratko, vendar vedno obravnavajte podpisane URL-je za prenos kot potekle.
Uporabite omejen eksponentni povratek z motnjo za 429, 503 in ponovljive napake.
Obdelujte samo javne medije ali medije, do katerih imate dovoljen dostop. DRM in nadzori dostopa niso zaobšli.
Shranjujte ID-je zahtev in ID-je opravil v zasebnih operativnih dnevnikih. Ne beležite nepotrebno poslanih URL-jev.

Dostop do sheme se začne z aktivacijo pred raziskovanjem na EasyT. Ta vodeni pregled nato predstavi dodeljeno overjanje. Končni podatek je dokumentiran v oblikah zahtevka.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Vključite namen stranke, pričakovano mesečno obremenitev in zahtevane mreže v aktivacijsko opombo. EasyT lahko nato pravilno izbere obseg reševanja in nalog, preden ustvari enotni skrivni pogled.

Zahtevajte aktivacijo Ključi so omejeni na najemnika, preklicljivi in izdani prek kontaktnega obrazca. Anonimni skripti ne morejo izvajati nalog prenašalnika.