Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s EasyT

Ova referenca EasyT je vodič za implementaciju, a ne aktivna anonimna krajnja točka. Pristup produkciji započinje tek nakon što podrška odobri klijenta i dodijeli ograničenja.

EasytWorkspaceJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

API domaćin započinje vjerodajnicama aktiviranim podrškom na EasyT. Ova vođena provjera zatim predstavlja dodijeljenu krajnju točku najmoprimca. Završna činjenica je put poziva samo poslužitelja.

URL klijentahttps://easyt.io

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaEasytWorkspace

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

U EasyT, tajno pohranjivanje na strani poslužitelja dolazi na prvo mjesto kada se objašnjava Sigurnost vjerodajnica. Ta vođena provjera slijedi bez ugradnje klijentskog paketa i zatvara se na nikakvim javnim zapisnicima ili repozitorijima.

Rješavanje veze

Operacija razrješenja započinje otkrivanjem izvora na EasyT. Ova vođena provjera zatim predstavlja formate s jednog predanog URL-a. Konačna činjenica je da nema izmišljenih izlaza.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`input_url`	HTTPS URL	Da	Javna ili ovlaštena medijska stranica za analizu.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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

U EasyT, vraćena nepromijenjena vrijednost dolazi prva kada se objašnjava identifikator formata. Ta vođena provjera slijedi s dostupnošću po poveznici i završava bez pogađene oznake kvalitete.

Stvaranje i praćenje zadatka preuzimanja

Asinkrona priprema je polazna točka za stvaranje posla na EasyT. Vođena provjera zatim predstavlja kratki HTTP zahtjev i objašnjava ograničeno izvršavanje radnika.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`input_url`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`stream_choice`	string	Da	Točan ID iz odgovora na rješavanje.
`tenant`	string	-Ne. -Ne?	Dodijeljena domena klijenta. Obično se izostavlja.

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 PrihvaćenoSpremi workspace_job.

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

3SpremniOtvorite potpisani URL za preuzimanje.

Status	Značenje	Akcija klijenta
`queued`	Prihvaćeno u ograničeni red.	Ponovno anketiranje s odmakom.
`extracting`	Osvježavanje izvornih metapodataka ili rute.	Nastavite s glasovanjem.
`processing`	Preuzimanje, remiksanje ili spajanje.	Prikaz napretka poslužitelja.
`ready`	Potpisano preuzimanje je dostupno.	Pošaljite URL korisniku.
`failed`	Terminal strukturirana pogreška.	Pročitajte `error_code`. Ponovite samo kada se savjetuje.
`expired`	Privremeni izlaz je uklonjen.	Stvorite novi posao.

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

Za anketa poslova, EasyT počinje s početnim čekanjem od jedne sekunde. Njegova vođena provjera to povezuje s ograničenim povratnim odgodama i završava privremenom potpisanom dostavom.

Predvidljive pogreške

EasyT čini ugovor o pogrešci jednostavnim za pregled. Stranica počinje s jednim omotačem koji nije 2xx, prelazi na ID zahtjeva za podršku i jasno navodi predvidljivo rukovanje na klijentskoj strani.

{
  "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čno značenje	Akcija
400	Nevažeći URL, tijelo ili nedostupan format.	Ispravite zahtjev. Resolvirajte ponovno za formate.
401	Ključ nedostaje, nije valjan, istekao je ili ima pogrešan opseg.	Provjerite vjerodajnice na strani poslužitelja.
403	Zahtjev je odbio stanar ili izvorno pravilo.	Nemojte zaobići pravilnik. Kontaktirajte podršku.
404	Nepoznat ili istekao posao.	Stvorite novi posao ako je to prikladno.
429	Dostignuto je ograničenje zahtjeva ili aktivnih zadataka.	Čast `retry_after_seconds`.
503	Red čekanja/kapaciteta ili upstream privremeno nedostupan.	Pokušajte ponovno s eksponencijalnim backoff i jitter.

Ugovor o radu

EasyT odabire operativni dopuštenje tijekom pregleda, uravnotežujući potrebe aplikacije sa zdravljem pružatelja usluga.

Koristite idempotentnu logiku aplikacije i nikada ne pokrenite duplicirane poslove za isti klik korisnika.
Predmemorija rješava metapodatke kratko, ali uvijek tretira potpisane URL-ove za preuzimanje kao isteka.
Koristite ograničeni eksponencijalni backoff s jitterom za 429, 503 i ponovljive pogreške.
Obrađujte samo javne medije ili medije za koje imate ovlaštenje pristupa. DRM i kontrole pristupa nisu zaobiđene.
ID-ove zahtjeva i ID-ove poslova čuvajte u privatnim operativnim zapisnicima. Nemojte nepotrebno bilježiti poslane URL-ove.

Pristup shemi započinje aktivacijom prije istraživanja na EasyT. Ova vođena provjera zatim prikazuje dodijeljenu autentifikaciju. Konačna činjenica su dokumentirani oblici zahtjeva.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Uključite svrhu klijenta, očekivano mjesečno opterećenje i tražene mreže u bilješku o aktivaciji.EasyT tada može pravilno odabrati rješavanje i opseg poslova prije proizvodnje tajne s jednim pogledom.

Zatražite aktivaciju Ključevi su ograničeni na zakupca, opozivi su mogući i izdaju se putem obrasca za kontakt. Anonimni skripti ne mogu izvršavati preuzimanje radova.