Samo predogled – zahteva se aktivacija

Graditi prenose z EasyF

EasyF vnaprej prikaže vmesnik, tako da lahko razvijalci ocenijo svoje delo. Pregled podpore je še vedno potreben, preden obstaja živ ključ in meja uporabe.

EasyfClientJSON prek HTTPSAsinhroni opravkiVerifikacijske podatke z obsegom

Hitri začetek

Za razlago gostitelja API-ja EasyF loči poverilnice, aktivirane s podporo, od dodeljene končne točke najemnika. Potek v preprostem jeziku daje poti klicev samo na strežnik svoj prostor.

URL najemnikahttps://easyf.app

AvtentikacijaX-API-Key: pending_activation_…

Profil odjemalcaEasyfClient

Različica 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"}'

Varnost poverilnic se začne s shranjevanjem skrivnosti na strežniški strani na EasyF. Naslednji pogled zajema brez vdelave odjemalskega paketa. Stran ne hrani javnih dnevnikov ali vidnih repozitorijev.

Reši povezavo

Za razlago operacije Resolve, EasyF loči zaznavanje vira od formatov iz ene poslane URL povezave. Delovni tok v preprostem jeziku ne daje izmišljenim izhodom svojega mesta.

POST/v1/resolveObseg: razreši

Polje	Vrsta	Zahtevano	Opis
`asset_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
}

Identifikator oblike se začne z vrnjeno vrednostjo, ki je nespremenjena na EasyF. Naslednji pogled zajema razpoložljivost na povezavo.

Ustvarjanje in spremljanje opravila prenosa

EasyF predstavlja tri praktične točke za ustvarjanje delovnih mest. Prva je asinhrona priprava. Nato delovni tok v preprostem jeziku zajema kratek HTTP zahtevek. Njegova zadnja točka je omejena izvedba delavca.

POST/v1/jobsObseg: delovna mesta

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

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 SprejetoShrani delivery_id.

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

EasyF se približa anketiranju opravila z enosekundno začetno čakalno dobo, nato pa z omejenim odmikom.

Predvidljive napake

EasyF organizira pogodbo o napaki okoli enega ovojnika, ki ni 2xx. Njegovo potekanje v preprostem jeziku primerja ID zahteve za podporo. Predvidljivo ravnanje odjemalca ostaja končna preverba.

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

EasyF se dogovori o praktičnih mejah uporabe z vsakim odobrenim izdelkom, da ohrani predvidljiv vodeni potek dela.

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.

Za razlago dostopa do sheme EasyF loči aktivacijo pred raziskovanjem od dodeljene avtentikacije. Preprosto delovno tokovno opravilo daje dokumentiranim oblikam zahtev svoje mesto.

DOSTOP, KI GA PREGLEDUJE OPERATER

Aktivirajte prek podpore

Povejte EasyF, kaj gradite, kako pogosto bo klical API in kateri ponudniki so pomembni. Pregled odloči o dovoljenih operacijah, nato pa enkrat razkrije poverilnico, pri čemer shrani le njen varen povzetek.

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