Tikai priekšskatījums — nepieciešama aktivizācija

Izveidot lejupielādes ar EasyF

EasyF parāda saskarni iepriekš, lai izstrādātāji varētu novērtēt savu darbu. Pirms dzīvā atslēgas un lietošanas robežas pastāvēšanas joprojām ir nepieciešama atbalsta pārskatīšana.

EasyfClientJSON, izmantojot HTTPSAsinhronie darbiAptvertie akreditācijas dati

Ātrās sākšanas rokasgrāmata

Lai izskaidrotu API saimnieku, EasyF atdala atbalsta aktivizētās apliecības no piešķirtā nomnieka gala punkta. Vienkāršas valodas darbplūsma piešķir servera zvana ceļam savu vietu.

Nomnieka URLhttps://easyf.app

AutentifikācijaX-API-Key: pending_activation_…

Klienta profilsEasyfClient

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

Apliecību drošība sākas ar servera puses slepeno glabāšanu EasyF. Nākamais skats aptver klienta pakotnes neiekļaušanu. Lapa nesaglabā publiskus žurnālus vai redzamus krātuves.

Saites atrisināšana

Lai izskaidrotu Resolve darbību, EasyF atdala avota noteikšanu no formātiem no viena iesniegtā URL. Vienkāršā valodā izteikts darba plūsmas apraksts nedod izgudrotiem rezultātiem savu vietu.

PAST/v1/resolveDarbības joma: atrisināt

Lauks	Tips	Nepieciešams	Apraksts
`asset_url`	HTTPS URL	Jā	Publiska vai pilnvarota mediju lapa analīzei.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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

Formāta identifikators sākas ar atgriezto vērtību nemainītu EasyF. Nākamais skats aptver pieejamību pa saitēm. Lapa nesaglabā redzamu minēto kvalitātes etiķeti.

Izveidot un sekot lejupielādes uzdevumam

EasyF piedāvā trīs praktiskus punktus Darba radīšanai. Pirmais ir asinhrona sagatavošana. Vienkāršā valodā aprakstītā darba plūsma aptver īsu HTTP pieprasījumu. Tās pēdējais punkts ir ierobežota darbinieka izpilde.

PAST/v1/jobsDarbības joma: darba vietas

Lauks	Tips	Nepieciešams	Apraksts
`asset_url`	HTTPS URL	Jā	Tika iesniegts tas pats normalizētais avots, lai atrisinātu.
`variant_code`	virkne	Jā	Precīzs ID no atrisināšanas atbildes.
`tenant`	virkne	Nē	Piešķirtais nomnieka domēns. Parasti izlaists.

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 PieņemtsSaglabāt delivery_id.

2Aptaujas statussGET /v1/jobs/{delivery_id} ar to pašu atslēgu.

3GatavsAtvērt parakstīto lejupielādes URL.

Statuss	Nozīme	Klienta darbība
`queued`	Iesniegts ierobežotajā rindā.	Aptauja vēlreiz ar atkāpšanos.
`extracting`	Avota metadatu vai maršruta atsvaidzināšana.	Turpiniet aptauju.
`processing`	Lejupielāde, pārkodēšana vai apvienošana.	Parādīt servera progresu.
`ready`	Parakstīta lejupielāde ir pieejama.	Nosūtiet vietrādi URL lietotājam.
`failed`	Termināla strukturēta kļūda.	Lasīt `error_code`Atkārtojiet mēģinājumu tikai tad, kad ieteicams.
`expired`	Pagaidu izvade tika noņemta.	Izveidojiet jaunu darbu.

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

EasyF pieejas Darba aptauja, izmantojot vienas sekundes sākotnējo gaidīšanu, pēc tam ierobežotu atkāpšanos. Vienkāršās valodas darbplūsma saglabā pagaidu parakstītu piegādi skaidri.

Paredzamās kļūdas

EasyF organizē Kļūdu līgumu ap vienu ne-2xx aploksni. Tās vienkāršās valodas darbplūsma salīdzina atbalsta pieprasījuma ID. Prognozējama klienta apstrāde paliek galīgā pārbaude.

{
  "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	Tipiska nozīme	Darbība
400	Nederīgs URL, pamatteksts vai nepieejams formāts.	Labojiet pieprasījumu. Mēģiniet vēlreiz formātiem.
401	Trūkst, nederīgs, beidzies vai nepareiza darbības joma atslēga.	Pārbaudīt servera puses akreditācijas datus.
403	Nomnieka vai avota politika noraidīja pieprasījumu.	Nepārkāpiet politiku. Sazinieties ar atbalstu.
404	Nezināms vai beidzies darba laiks.	Ja nepieciešams, izveidojiet jaunu uzdevumu.
429	Sasniegts pieprasījumu vai aktīvo darbu ierobežojums.	Gods `retry_after_seconds`.
503	Rinda/kapacitāte vai augšupejošais savienojums pagaidām nav pieejams.	Atkārtoti mēģiniet ar eksponenciālu atpakaļejošu aizkavi un traucējumiem.

Darbības līgums

EasyF vienojas par praktiskas lietošanas robežām ar katru apstiprināto produktu, lai saglabātu paredzamu vadītu darbplūsmu.

Izmantojiet idempotent lietojumprogrammu loģiku un nekad nesāciet dublēt darbus vienam un tam pašam lietotāja klikšķim.
Kešatmiņa īsi atrisina metadatus, bet vienmēr uzskata, ka parakstītie lejupielādes URL ir beigušies.
Izmantojiet ierobežotu eksponenciālo atpakaļejošo aizkavi ar nejaušību 429, 503 un atkārtojamām kļūdām.
Apstrādājiet tikai publisku multividi vai multividi, kurai jums ir piekļuve. DRM un piekļuves kontroles netiek apietas.
Saglabājiet pieprasījumu ID un darba ID privātos darbības žurnālos. Nelietojiet iesniegtos URL nevajadzīgi.

Lai izskaidrotu shēmas piekļuvi, EasyF atdala aktivizāciju pirms izpētes no piešķirtās autentifikācijas. Vienkārša darbplūsma piešķir dokumentētām pieprasījuma formām savu vietu.

EKSPLUATANTA PĀRBAUDĪTA PIEKĻUVE

Aktivizēšana, izmantojot atbalstu

Pastāstiet EasyF, ko jūs veidojat, cik bieži tas izsauks API un kuri pakalpojumu sniedzēji ir svarīgi. Pārskats nosaka atļautās darbības, pēc tam atklāj akreditācijas datus vienu reizi, saglabājot tikai tā drošo kopsavilkumu.

Pieprasīt aktivizāciju Atslēgas ir īrnieka mērogā, atsaucamas un izsniegtas caur Kontaktformu. Anonīmi skripti nevar izpildīt lejupielādētāja darbu.