https://easyf.appNdërto shkarkimet me EasyF
EasyF tregon ndërfaqen paraprakisht në mënyrë që zhvilluesit të mund të vlerësojnë punën e tyre. Një rishikim mbështetës është ende i nevojshëm para se të ekzistojë një çelës i drejtpërdrejtë dhe një kufi përdorimi.
EasyfClientJSON mbi HTTPSPunë asinkroneKredenciale me shtrirje
01
Fillimi i shpejtë
Për të shpjeguar hostin e API-së, EasyF ndan kredencialet e aktivizuara nga mbështetja nga një pikë përfundimtare e caktuar e qiramarrësit. Një proces në gjuhë të thjeshtë i jep një rruge thirrjeje vetëm për serverin vendin e vet.
X-API-Key: pending_activation_…EasyfClientv1# 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"}'Siguria e kredencialeve fillon me ruajtjen e fshehtë në anën e serverit në EasyF. Pamja tjetër nuk përfshin asnjë paketë klienti të ngulitur. Faqja nuk mban asnjë regjistër publik apo depo të dukshme.
02
Zgjidh një lidhje
Për të shpjeguar operacionin Resolve, EasyF ndan zbulimin e burimit nga formatet nga një URL e dorëzuar. Një proces në gjuhë të thjeshtë nuk i jep vend asnjë rezultati të shpikur.
POST
/v1/resolveFusha e veprimit: zgjidh| Fusha | Lloji | I domosdoshëm | Përshkrimi |
|---|---|---|---|
asset_url | URL HTTPS | Po | Faqe publike ose e autorizuar e mediave për të analizuar. |
tenant | varg | Jo. | Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë. |
{
"success": true,
"platform": "youtube",
"title": "Example video",
"formats": [
{"id":"18","type":"video","quality":"360p","container":"mp4"}
],
"cached": false
}Identifikuesi i formatit fillon me vlerën e kthyer pa ndryshuar në EasyF. Pamja tjetër mbulon disponueshmërinë për çdo lidhje. Faqja nuk mban asnjë etiketë cilësie të supozuar të dukshme.
03
Krijoni dhe ndiqni një punë shkarkimi
EasyF paraqet tre pika praktike për krijimin e punës. E para është përgatitja asinkrone. Procesi i punës në gjuhë të thjeshtë mbulon më pas një kërkesë të shkurtër HTTP. Pika e fundit është ekzekutimi i kufizuar i punëtorit.
POST
/v1/jobsFusha e veprimit: punët| Fusha | Lloji | I domosdoshëm | Përshkrimi |
|---|---|---|---|
asset_url | URL HTTPS | Po | I njëjti burim i normalizuar i paraqitur për të zgjidhur. |
variant_code | varg | Po | Një ID e saktë nga përgjigja e zgjidhjes. |
tenant | varg | Jo. | Domain i caktuar i qiramarrësit. Zakonisht lënë jashtë. |
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"}'delivery_id.GET /v1/jobs/{delivery_id} me të njëjtin çelës.| Gjendja | Kuptimi | Veprimi i klientit |
|---|---|---|
queued | pranohet në radhën e kufizuar. | Sondazh përsëri me prapambetje. |
extracting | Rifreskim i metatë dhënave të burimit ose rrugës. | Vazhdoni votimin. |
processing | Shkarkimi, ripërzierja ose bashkimi. | Shfaq përparimin e serverit. |
ready | Shkarkimi i nënshkruar është në dispozicion. | Dërgoni URL-në për përdoruesin. |
failed | Gabim i strukturuar i terminalit. | Lexo error_code. Riprovoni vetëm kur këshilloheni. |
expired | Dalja e përkohshme u hoq. | Krijoni një punë të re. |
curl https://easyf.app/v1/jobs/DELIVERY_ID \
-H "X-API-Key: $EASYF_SERVICE_KEY"EasyF i afrohet votimit të punës përmes pritjes fillestare një sekondëshe, pastaj i mbyll prapa. Fluksi i punës në gjuhë të thjeshtë mban dorëzimin e nënshkruar të përkohshëm të qartë.
04
Gabimet e parashikueshme
EasyF organizon kontratën e gabimit rreth një zarfi jo-2xx. Procesi i tij në gjuhë të thjeshtë krahason një ID kërkese mbështetëse. Trajtimi i parashikueshëm i klientit mbetet kontrolli përfundimtar.
{
"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 | Kuptimi tipik | Veprim |
|---|---|---|
| 400 | URL e pavlefshme, trup ose format i papërdorshëm. | Korrigjo kërkesën. Zgjidh përsëri për formatet. |
| 401 | Mungon, i pavlefshëm, i skaduar ose me hapësirë të gabuar kyçi. | Kontrolloni kredencialet e anës së serverit. |
| 403 | Qiramarrësi ose politika e burimit refuzoi kërkesën. | Mos anashkaloni politikën. Kontaktoni mbështetjen. |
| 404 | Punë e panjohur ose e skaduar. | Krijoni një punë të re nëse është e përshtatshme. |
| 429 | Arrihet kufiri i kërkesave ose i punëve aktive. | Nderi retry_after_seconds. |
| 503 | Radhë/kapaciteti ose upstream përkohësisht jo i disponueshëm. | Riprovoni me prapambetje eksponenciale dhe jitter. |
05
Kontrata operative
EasyF pajtohet me kufijtë praktikë të përdorimit me çdo produkt të miratuar për të ruajtur një rrjedhë të parashikueshme të udhëhequr të punës.
- Përdorni logjikën e aplikimit idempotent dhe kurrë mos filloni punë të dyfishta për të njëjtin klikim të përdoruesit.
- Cache zgjidh metadata shkurt, por gjithmonë trajtoni URL-të e nënshkruara të shkarkimit si të skaduara.
- Përdorni prapavijëzim eksponencial të kufizuar me jitter për
429,503dhe gabimet e riprovueshme. - Përpuno vetëm media publike ose media që jeni të autorizuar të aksesoni. DRM dhe kontrollet e aksesit nuk anashkalohen.
- Mbani ID-të e kërkesave dhe ID-të e punëve në regjistrat e operacioneve private. Mos regjistroni URL-të e dërguara pa nevojë.
Për të shpjeguar aksesin në Skemë, EasyF ndan aktivizimin para eksplorimit nga autentikimi i caktuar. Një rrjedhë pune në gjuhë të thjeshtë i jep formave të kërkesës të dokumentuara vendin e vet.
Aktivizoni përmes mbështetjes
Tregoni EasyF se çfarë po ndërtoni, sa shpesh do të thërrasë API-në dhe cilët ofrues janë të rëndësishëm. Rishikimi vendos operacionet e lejuara, pastaj zbulon një kredencial një herë duke ruajtur vetëm përmbledhjen e tij të sigurt.
Kërkojë aktivizimin Çelësat janë të shtrirë në qira, të revokueshme dhe të lëshuara përmes formularit të Kontaktit. Skriptet anonime nuk mund të ekzekutojnë punën e shkarkuesit.