Tik peržiūra – reikia aktyvinti

Kurkite atsisiuntimus su EasyF

EasyF iš anksto rodo sąsają, kad kūrėjai galėtų įvertinti savo darbą. Vis dar reikalingas palaikymo peržiūra prieš gyvą raktą ir naudojimo ribą.

EasyfClientJSON per HTTPSAsinchroniniai darbaiApimties kredencialai

Greita pradžia

Paaiškinti API prieglobą EasyF atskiria palaikymo aktyvuotus sertifikatus nuo priskirto nuomininko galutinio taško. Paprasto kalbos darbo eiga suteikia serverio tik skambučių keliui atskirą vietą.

Nuomotojo URLhttps://easyf.app

Autentiškumo patvirtinimasX-API-Key: pending_activation_…

Kliento profilisEasyfClient

API versijav1

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

Sertifikato saugumas prasideda nuo serverio pusės slaptos saugyklos EasyF. Kitas vaizdas apima jokio kliento paketo įterpimo nebuvimą. Puslapis nelaiko viešų žurnalų ar matomų saugyklų.

Nuorodos išsprendimas

Paaiškinti Resolve operaciją, EasyF atskiria šaltinio aptikimą nuo formatų iš vieno pateikto URL. Paprasto kalbos darbo eiga nesuteikia išgalvotiems rezultatams atskiros vietos.

POST/v1/resolveTaikymo sritis: išspręsti

Laukas	Tipas	Būtinas	Aprašymas
`asset_url`	HTTPS URL	Taip	Viešas arba įgaliotas žiniasklaidos puslapis analizuoti.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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

Formatų identifikatorius prasideda nuo grąžintos reikšmės, nekeičiant jos EasyF. Kitas vaizdas apima prieinamumą pagal nuorodą. Puslapis nerodo spėjamos kokybės žymos.

Atsisiuntimo užduoties kūrimas ir sekimas

EasyF pateikia tris praktinius darbo kūrimo punktus. Pirmiausia vyksta asinchroninis pasiruošimas. Paprasto teksto darbo eiga apima trumpą HTTP užklausą. Jos paskutinis punktas yra ribotas darbininko vykdymas.

POST/v1/jobsTaikymo sritis: darbo vietos

Laukas	Tipas	Būtinas	Aprašymas
`asset_url`	HTTPS URL	Taip	Tas pats normalizuotas šaltinis pateiktas išspręsti.
`variant_code`	eilutė	Taip	Tikslus ID iš atsakymo į sprendimą.
`tenant`	eilutė	Ne	Priskirtas nuomotojo domenas. Paprastai praleidžiamas.

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 PriimtaIšsaugoti delivery_id.

2Apklausos būsenaGET /v1/jobs/{delivery_id} tuo pačiu raktu.

3ParuoštaAtidarykite pasirašytą atsisiuntimo URL.

Būsena	Reikšmė	Kliento veiksmas
`queued`	Priimtas į ribotą eilę.	Apklausa vėl su atgal.
`extracting`	Atnaujinami šaltinio metaduomenys arba maršrutas.	Tęskite apklausą.
`processing`	Parsisiuntimas, remiksas ar sujungimas.	Rodyti serverio pažangą.
`ready`	Pasirašytas atsisiuntimas yra prieinamas.	Siųsti URL vartotojui.
`failed`	Terminalo struktūrinė klaida.	Skaityti `error_code`Bandykite dar kartą tik tada, kai patartina.
`expired`	Laikinas išėjimas buvo pašalintas.	Sukurkite naują darbą.

curl https://easyf.app/v1/jobs/DELIVERY_ID \
  -H "X-API-Key: $EASYF_SERVICE_KEY"

EasyF prieina prie užduočių tikrinimo per vienos sekundės pradinį laukimą, po to taikomas ribotas atidėjimas. Paprastos kalbos darbo eiga aiškiai nurodo laikino pasirašyto pristatymo procesą.

Numatomos klaidos

EasyF organizuoja Klaidos sutartį aplink vieną ne-2xx voką. Jos paprasto kalbos darbo eiga lygina palaikymo užklausos ID. Nuspėjamas kliento tvarkymas lieka galutiniu patikrinimu.

{
  "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ška reikšmė	Veiksmas
400	Netinkamas URL, tekstas arba negalimas formatas.	Ištaisykite užklausą. Išspręskite dar kartą formatams.
401	Trūksta, negalioja, pasibaigė galiojimo laikas arba neteisingos apimties raktas.	Patikrinkite serverio pusės kredencialus.
403	Nuomininkas arba šaltinio strategija atmetė užklausą.	Neaplenkite politikos. Susisiekite su palaikymo tarnyba.
404	Nežinomas arba pasibaigęs darbas.	Jei reikia, sukurkite naują darbą.
429	Pasiektas užklausos arba aktyvių užduočių limitas.	Garbė `retry_after_seconds`.
503	Eilė / talpa arba priešsroviui laikinai neprieinama.	Bandykite dar kartą su eksponentiniu atgal ir drebėjimu.

Veiklos sutartis

EasyF sutaria praktinio naudojimo ribas su kiekvienu patvirtintu produktu, kad išsaugotų nuspėjamą vadovaujamą darbo eigą.

Naudokite idempotentinę programos logiką ir niekada nepradėkite pasikartojančių užduočių tam pačiam vartotojo paspaudimui.
Talpykloje trumpai išsprendžiami metaduomenys, tačiau visada pasirašyti atsisiuntimo URL laikomi pasibaigusiais.
Naudokite ribotą eksponentinį atgalinį atmetimą su drebėjimu, kad 429, 503 ir pakartotinai bandomos klaidos.
Apdorokite tik viešąją laikmeną arba laikmeną, prie kurios turite prieigą. DRM ir prieigos kontrolės priemonės nebus apeitos.
Saugokite užklausų ID ir užduočių ID privačiuose veiklos žurnaluose. Nereikia registruoti pateiktų URL be reikalo.

Norint paaiškinti Schema prieigą, EasyF atskiria aktyvavimą prieš tyrimą nuo priskirtos autentifikacijos. Paprasto kalbos darbo eiga suteikia dokumentuotoms užklausų formoms savą vietą.

EKSPLOATUOTOJO PERŽIŪRIMAS

Aktyvinkite per palaikymą

Pasakykite EasyF, ką kuriate, kaip dažnai jis kvies API ir kurie tiekėjai yra svarbūs. Peržiūra nusprendžia leidžiamas operacijas, tada vieną kartą atskleidžia kredencialą, saugodama tik jo saugų santrauką.

Prašykite aktyvavimo Raktai yra nuomininko apimties, atšaukiami ir išduodami per Susisiekite formą. Anoniminiai scenarijai negali vykdyti atsisiuntimo programos darbo.