Samo pregled – potrebna je aktivacija

Izgradite preuzimanja s EasyF

EasyF pokazuje sučelje unaprijed tako da programeri mogu procijeniti svoj rad. Pregled podrške je još uvijek potreban prije nego što postoji živi ključ i granica uporabe.

EasyfClientJSON preko HTTPS-aAsinkroni posloviVjerodajnice s opsegom

Brzi početak rada

Da bi objasnio API domaćin, EasyF odvaja vjerodajnice aktivirane podrškom od dodijeljene krajnje točke najmoprimca. Tijek rada na običnom jeziku daje put poziva samo poslužitelja svoje mjesto.

URL klijentahttps://easyf.app

AutentifikacijaX-API-Key: pending_activation_…

Profil klijentaEasyfClient

Verzija API-jav1

# Available only after support activation
export EASYF_SERVICE_KEY="issued-after-review"

curl -X POST https://easyf.app/v1/resolve \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID"}'

Sigurnost vjerodajnica započinje tajnim spremištem na strani poslužitelja na EasyF. Sljedeći pogled ne pokriva ugradnju klijentskog paketa. Stranica ne čuva vidljive javne zapisnike ili repozitorije.

Rješavanje veze

Kako bi objasnio operaciju Resolve, EasyF odvaja otkrivanje izvora od formata iz jednog poslanog URL-a. Radni tijek na jednostavnom jeziku ne daje izmišljenim izlazima vlastito mjesto.

POST/v1/resolveOpseg: riješiti

Polje	Tip	Obvezno	Opis
`asset_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
}

Identifikator formata počinje s vraćenom vrijednošću nepromijenjenom na EasyF. Sljedeći prikaz pokriva dostupnost po vezi. Stranica ne drži vidljivu oznaku nagađanja kvalitete.

Stvaranje i praćenje zadatka preuzimanja

EasyF predstavlja tri praktične točke za stvaranje poslova. Prvo dolazi asinkrona priprema. Tijek rada na običnom jeziku zatim pokriva kratki HTTP zahtjev. Njegova posljednja točka je izvršenje ograničenog radnika.

POST/v1/jobsPodručje primjene: poslovi

Polje	Tip	Obvezno	Opis
`asset_url`	HTTPS URL	Da	Isti normalizirani izvor predan za rješavanje.
`variant_code`	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://easyf.app/v1/jobs \
  -H "X-API-Key: $EASYF_SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"asset_url":"https://www.youtube.com/watch?v=VIDEO_ID","variant_code":"18"}'

1202 PrihvaćenoSpremi delivery_id.

2Status anketeGET /v1/jobs/{delivery_id} 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://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF pristupa Job polling kroz jednu sekundu početnog čekanja, a zatim ograničeno backoff. Radni tijek na običnom jeziku čuva privremenu potpisanu isporuku eksplicitno.

Predvidljive pogreške

EasyF organizira ugovor o pogrešci oko jedne omotnice koja nije 2xx. Njegov tijek rada na običnom jeziku uspoređuje ID zahtjeva za podršku. Predvidljivo rukovanje klijentom ostaje posljednja provjera.

{
  "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

EasyF dogovara praktične granice korištenja s svakim odobrenim proizvodom kako bi se sačuvao predvidljiv vođeni tijek rada.

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.

Kako bi objasnio pristup Shemi, EasyF odvaja aktivaciju prije istraživanja od dodijeljene autentifikacije. Radni tijek na jednostavnom jeziku daje dokumentiranim oblicima zahtjeva posebno mjesto.

PRISTUP KOJI PREGLEDA OPERATER

Aktivirajte se putem podrške

Recite EasyF što izrađujete, koliko često će pozivati API i koji pružatelji usluga su važni. Pregled odlučuje o dopuštenim operacijama, a zatim jednom otkriva vjerodajnicu dok sprema samo njezin sigurni sažetak.

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.