Len ukážka – vyžaduje sa aktivácia

Zostavte si stiahnutia s EasyT

Táto referencia služby EasyT je návod na implementáciu, nie aktívny anonymný koncový bod. Produkčný prístup sa začína až po schválení klienta podporou a pridelení limitov.

EasytWorkspaceJSON cez HTTPSAsynchrónne úlohyPoverenia s rozsahom

Rýchly štart

Prístup k hostiteľovi API v službe EasyT začína prihlasovacími údajmi aktivovanými podporou. Nasleduje pridelený koncový bod nájomníka a volania vykonávané výhradne zo servera.

URL nájomcuhttps://easyt.io

AutentifikáciaX-API-Key: pending_activation_…

Profil klientaEasytWorkspace

Verzia APIv1

# 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 pri ochrane prihlasovacích údajov zdôrazňuje uchovávanie tajných údajov na serveri. Nesmú byť vložené do klientskeho balíka ani zverejnené v protokoloch alebo repozitároch.

Vyriešiť odkaz

Operácia rozpoznania v službe EasyT začína určením zdroja. Z jednej zadanej adresy URL potom získa formáty; žiadne výstupy si nevymýšľa.

POŠTA/v1/resolveRozsah: vyriešiť

Pole	Typ	Povinné	Popis
`input_url`	HTTPS URL	Áno	Verejná alebo oprávnená mediálna stránka na analýzu.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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

EasyT pri identifikátore formátu zachováva získanú hodnotu bez zmeny. Dostupnosť závisí od konkrétneho odkazu a označenie kvality sa neodhaduje.

Vytvorte a sledujte úlohu sťahovania

Vytvorenie úlohy v službe EasyT spúšťa asynchrónnu prípravu. Používa krátku požiadavku HTTP a časovo či kapacitne ohraničené vykonávanie pracovným procesom.

POŠTA/v1/jobsRozsah: pracovné ponuky

Pole	Typ	Povinné	Popis
`input_url`	HTTPS URL	Áno	Rovnaký normalizovaný zdroj predložený na vyriešenie.
`stream_choice`	reťazec	Áno	Presné ID z odpovede na vyriešenie.
`tenant`	reťazec	Nie	Priradená doména nájomníka. Zvyčajne sa vynecháva.

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 prijatéUložiť workspace_job.

2Stav anketyGET /v1/jobs/{workspace_job} s rovnakým kľúčom.

3PripravenýOtvorte podpísanú URL adresu na stiahnutie.

Stav	Význam	Akcia klienta
`queued`	Prijatý do ohraničeného frontu.	Anketa znova s odstupom.
`extracting`	Obnovovanie zdrojových metadát alebo trasy.	Pokračujte v hlasovaní.
`processing`	Sťahovanie, remuxovanie alebo spájanie.	Zobrazenie priebehu servera.
`ready`	Podpísané stiahnutie je k dispozícii.	Odoslanie URL adresy používateľovi.
`failed`	Terminál štruktúrovaná chyba.	Čítať `error_code`Opakujte pokus iba v prípade, že vám to odporučia.
`expired`	Dočasný výstup bol odstránený.	Vytvorte novú úlohu.

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

Pre Job polling, EasyT začína s jednosekundovým počiatočným čakaním, jeho riadená kontrola spáruje toto s obmedzeným spätným odchodom a končí dočasným podpísaným doručením.

Predvídateľné chyby

EasyT prehľadne vysvetľuje zmluvu chybových odpovedí: jednotný obal odpovede mimo rozsahu 2xx, identifikátor požiadavky pre podporu a predvídateľné spracovanie na strane klienta.

{
  "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	Typický význam	Akcia
400	Neplatná adresa URL, telo alebo nedostupný formát.	Opravte požiadavku. Vyriešte znova pre formáty.
401	Chýbajúci, neplatný, neplatný alebo nesprávny rozsah kľúča.	Skontrolujte poverenie na strane servera.
403	Nájomca alebo zdrojová politika odmietli žiadosť.	Neobchádzajte pravidlá. Obráťte sa na podporu.
404	Neznáma alebo vypršaná pracovná ponuka.	V prípade potreby vytvorte novú úlohu.
429	Dosiahnutý limit požiadaviek alebo aktívnych úloh.	Česť `retry_after_seconds`.
503	Fronta/kapacita alebo upstream dočasne nedostupné.	Skúste to znova s exponenciálnym spätným odrazom a jitterom.

Prevádzková zmluva

EasyT vyberá prevádzkový limit počas kontroly, pričom vyvažuje potreby aplikácie so stavom poskytovateľa.

Používajte idempotentnú aplikačnú logiku a nikdy nespúšťajte duplicitné úlohy pre to isté kliknutie používateľa.
Vyrovnávacia pamäť vyriešiť metadáta krátko, ale vždy zaobchádzať podpísané stiahnuť URL ako vypršať.
Použite ohraničený exponenciálny spätný chod s jitterom pre 429, 503 a opakovatelné chyby.
Spracovávajte iba verejné médiá alebo médiá, ku ktorým máte oprávnený prístup. DRM a kontroly prístupu nie sú obídené.
Uchovávajte ID žiadostí a ID úloh v súkromných prevádzkových denníkoch. Nezapisujte odoslané adresy URL zbytočne.

Prístup k schéme v službe EasyT vyžaduje aktiváciu ešte pred jej preskúmaním. Používa pridelené overenie totožnosti a zdokumentované tvary požiadaviek.

PRÍSTUP KONTROLOVANÝ OPERAČOM

Aktivácia prostredníctvom podpory

V žiadosti o aktiváciu uveďte účel klienta, očakávaný mesačný objem práce a požadované siete. EasyT tak môže správne určiť rozsah oprávnení na rozpoznávanie a úlohy pred vytvorením tajného údaja zobraziteľného iba raz.

Požiadať o aktiváciu Kľúče sú viazané na nájomníka, možno ich odvolať a vydávajú sa prostredníctvom kontaktného formulára. Anonymné skripty nemôžu vykonávať prácu sťahovača.