REST, status endpoint és abilities

Admin REST

Az /wp-json/lw-scan/v1/ útvonalak a felület hátterét adják. Mind adminisztrátori jogot (manage_options) kér, és alkalmazásjelszóval is hívható.

Metódus	Útvonal	Mire
GET	/scan, /scan/status	Futásállapot.
POST	/scan/start	Indítás: scope (full, changed, db, path), path, heuristics, resume. Válasz: {run_id}; ha már fut egy, 409.
POST	/scan/tick	Egy rövid lépés továbbvitele, ha az oldal nem éri el saját magát.
POST	/scan/stop	Leállítás.
GET	/findings	Találatok: severity, type, state, search, page, per_page.
POST	/findings/state	Állapotváltás: ids, state (new, acknowledged, ignored).
POST	/findings/clear	Összes találat törlése (futás alatt 409).
GET	/health	Állapotfelmérés.
POST	/maintenance/bundle, /maintenance/index	Csomagfrissítés, index újraépítése.
GET, POST	/settings	Beállítások olvasása, részleges mentése.
POST	/notify/test	Teszt e-mail.
GET, POST	/status-endpoint; POST /status-endpoint/rotate	A status endpoint kezelése.

Mindig küldd a heuristics értéket

A POST /scan/start a heuristics értékét a mentett beállításba írja. Ha kihagyod, a heurisztika tartósan kikapcsol. Külső hívásnál mindig küldd: "heuristics": true.

Teljes vizsgálat indítása

curl -u "admin:xxxx xxxx xxxx xxxx xxxx xxxx" -X POST \
  -H 'Content-Type: application/json' \
  -d '{"scope":"full","heuristics":true}' \
  https://pelda.hu/wp-json/lw-scan/v1/scan/start

Új riasztások listája

curl -u "admin:xxxx xxxx xxxx xxxx xxxx xxxx" \
  'https://pelda.hu/wp-json/lw-scan/v1/findings?severity=alert&state=new&per_page=20'

Találatok nyugtázása

curl -u "admin:xxxx xxxx xxxx xxxx xxxx xxxx" -X POST \
  -H 'Content-Type: application/json' \
  -d '{"ids":[12,15],"state":"acknowledged"}' \
  https://pelda.hu/wp-json/lw-scan/v1/findings/state

A böngészőn kívül indított vizsgálat a WP-Cron lépésein halad. Ha az oldal nem éri el saját magát, WP-CLI-vel vagy a /scan/tick hívogatásával vihető tovább.

Status endpoint

GET /wp-json/lw-scan/v1/status/<kulcs>, bejelentkezés nélkül. A kulcsot az Állapot fülön vagy a wp lw-scan endpoint url paranccsal kapod meg. Rossz kulcsra ugyanúgy 404-et ad, mint egy nem létező útvonalra, és a nyilvános REST-listában sem szerepel.

Paraméter	Mit csinál
?http_status=1	503-at ad, amíg az állapot crit. HTTP-állapotkódot figyelő monitorozóhoz.
?fresh=1	A tárolt eredmény helyett újraellenőriz.

Terminál

curl -s https://pelda.hu/wp-json/lw-scan/v1/status/<kulcs>
curl -s -o /dev/null -w '%{http_code}\n' 'https://pelda.hu/wp-json/lw-scan/v1/status/<kulcs>?http_status=1'

A válasz mezői: overall, checked_at, cached, site (url, wp, php, lw_scan), és checks.lw_scan (status, summary, details, checked_at, duration_ms). A status értékei:

Érték	Jelentés
ok	rendben
warn	az utolsó futás hibás, vagy két ütemezett ablakban nem volt sikeres futás
crit	van új riasztás
unknown	még nem volt vizsgálat

Ha egy másik bővítmény bejelentkezéshez köti a REST API-t (pl. az LW Disable REST API-letiltása), a monitor 401-et kap.

Abilities (az LW Site Manager mellett)

Ha az LW Site Manager is aktív, négy képesség jelenik meg „Kártevő-vizsgálat” kategóriában. Mind adminisztrátori jogot kér.

Ability	Mire	Bemenet
lw-scan/run	vizsgálat indítása	scope (kötelező), path, resume
lw-scan/status	állapot	nincs
lw-scan/findings	találatok listája	severity, type, state, page, per_page (legfeljebb 200)
lw-scan/acknowledge	találat állapotának állítása	ids, state (kötelező)

A WordPress Abilities REST-felületén hívhatók: /wp-json/wp-abilities/v1/abilities/<név>/run, olvasáshoz GET, íráshoz POST {"input": {...}} törzzsel. Az abilityvel indított vizsgálat nem írja át a mentett heurisztika-beállítást.

Szűrők és akciók

Saját wp-config-konstans nincs.

Szűrő	Mire jó
lw_scan_options	A beállítások felülírása az adott kérésre; nem íródik vissza az adatbázisba.
lw_scan_storage_dir	A privát tárhelymappa helye (alap: wp-content/lw-scan); a kizárási lista automatikusan követi.
lw_scan_api_base	A szignatúra- és adatforrás alapcíme (alap: https://scan-data.lwplugins.com).

Akciók: lw_scan_upgraded ($from, $to: frissítés után egyszer), lw_scan_phase_changed ($phase, $stats: új fázis indulásakor).

HelloPack Client

Ha a HelloPack Client telepítve van, megjelenik benne egy lw_scan állapot-ellenőrzés: új riasztás, sikertelen utolsó futás, leállt ütemezés. Csak olvas.