Pouze náhled — vyžaduje aktivaci

Sestavte stahování s EasyT

Tento odkaz EasyT je implementační průvodce, nikoli aktivní anonymní koncový bod. Produkční přístup začíná až po schválení klienta podporou a přiřazení limitů.

EasytWorkspaceJSON přes HTTPSAsynchronní úlohyPověření s rozsahem

Rychlý start

Hostitel rozhraní API začíná s podporou aktivovaných přihlašovacích údajů na EasyT. Tato řízená kontrola pak zobrazí přiřazený koncový bod tenanta. Konečným faktem je cesta volání pouze pro server.

URL klientahttps://easyt.io

AutentizaceX-API-Key: pending_activation_…

Profil klientaEasytWorkspace

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

V EasyT, při vysvětlování bezpečnosti přihlašovacích údajů je na prvním místě server-side úložiště tajemství. Tato kontrola v pořadí následuje s žádným vkládáním do klientského balíčku a končí bez veřejných logů nebo repozitářů.

Vyřešit odkaz

Operace Resolve začíná detekcí zdroje na EasyT. Tato vedená kontrola pak zobrazí formáty z jedné odeslané adresy URL. Konečným faktem je, že nejsou žádné vymyšlené výstupy.

POST/v1/resolveRozsah: vyřešit

Pole	Typ	Povinné	Popis
`input_url`	HTTPS	Ano	Veřejná nebo autorizovaná mediální stránka k analýze.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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

V EasyT je vrácená hodnota nezměněna první při vysvětlení identifikátoru formátu. Tato řízená kontrola následuje s dostupností na odkaz a uzavírá se na žádném hádaném štítku kvality.

Vytvoření a sledování úlohy stahování

Asynchronní příprava je výchozím bodem pro vytvoření úlohy na EasyT. Následně se zobrazí řízená kontrola s krátkým požadavkem HTTP a vysvětlením omezeného vykonávání pracovníků.

POST/v1/jobsRozsah: pracovní místa

Pole	Typ	Povinné	Popis
`input_url`	HTTPS	Ano	Stejný normalizovaný zdroj předložený k vyřešení.
`stream_choice`	řetězec	Ano	Přesné ID z odpovědi na překlad.
`tenant`	řetězec	Ne.	Přiřazená doména klienta. Obvykle se vynechává.

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 PřijatoSave workspace_job.

2Stav hlasováníGET /v1/jobs/{workspace_job} se stejným klíčem.

3PřipravenOtevřete podepsanou adresu URL ke stažení.

Stav	Význam	Akce klienta
`queued`	Připuštěn do ohraničené fronty.	Anketa znovu s backoff.
`extracting`	Obnovování zdrojových metadat nebo trasy.	Pokračujte v hlasování.
`processing`	Stahování, remixování nebo slučování.	Zobrazit průběh serveru.
`ready`	Podepsané stažení je k dispozici.	Odešlete uživateli adresu URL.
`failed`	Chyba struktury terminálu.	Přečtěte si `error_code`Zkuste to znovu pouze v případě, že je to doporučeno.
`expired`	Dočasný výstup byl odstraněn.	Vytvořte novou úlohu.

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

Pro dotazování úloh začíná EasyT jednosekundovým počátečním čekáním. Jeho řízená kontrola kombinuje toto čekání s omezeným zpětným odkladem a končí dočasným podepsaným doručením.

Předvídatelné chyby

EasyT usnadňuje rychlé procházení smlouvy Error. Stránka začíná jedním obalem mimo rozsah 2xx, přechází na ID požadavku podpory a jasně uvádí předvídatelné zpracování na straně 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": "…"
}

Hypertext Transfer Protocol	Typický význam	Akce
400	Neplatná adresa URL, tělo nebo nedostupný formát.	Opravte požadavek. Znovu vyřešte formáty.
401	Chybějící, neplatný, vypršený nebo nesprávný rozsah klíče.	Zkontrolujte pověření na straně serveru.
403	Klient nebo zdrojové zásady požadavek zamítly.	Nepřekračujte pravidla. Kontaktujte podporu.
404	Neznámá nebo vypršela pracovní pozice.	V případě potřeby vytvořte novou úlohu.
429	Dosáhli jste limitu požadavků nebo aktivních úloh.	Honor `retry_after_seconds`.
503	Fronta/kapacita nebo upstream dočasně nedostupné.	Zkuste to znovu s exponenciálním zpětným odstupem a jitterem.

Provozní smlouva

EasyT během kontroly vybírá provozní povolení, které vyvažuje potřeby aplikace a zdraví poskytovatele.

Používejte idempotentní aplikační logiku a nikdy nespouštějte duplicitní úlohy pro stejné uživatelské kliknutí.
Cache krátce vyřeší metadata, ale vždy považuje podepsané adresy URL ke stažení za vypršení platnosti.
Použijte ohraničený exponenciální backoff s jitter pro 429, 503 a opakovatelné chyby.
Zpracovávejte pouze veřejná média nebo média, ke kterým máte oprávnění. DRM a přístupová omezení nejsou obcházena.
ID požadavků a ID úloh uchovávejte v soukromých provozních protokolech. Nezapisujte do protokolů odeslané adresy URL zbytečně.

Přístup schématu začíná aktivací před průzkumem na EasyT. Tato řízená kontrola pak představuje přiřazené ověřování. Konečný fakt je zdokumentován požadavek tvary.

PŘÍSTUP PŘEZKOUMANÝ OPERATOREM

Aktivace prostřednictvím podpory

Do aktivační poznámky zahrňte účel klienta, očekávané měsíční pracovní zatížení a požadované sítě.EasyT může poté správně zvolit rozlišení a obory úloh před vytvořením tajného klíče s jedním zobrazením.

Požádat o aktivaci Klíče jsou omezeny na klienta, lze je odvolat a vydávají se prostřednictvím kontaktního formuláře.