Pornește și citește scanări WordPress
Pornește o scanare WP PerformanceShield pe un site prin API, așteaptă să se termine și citește scorul, constatările și vulnerabilitățile.
Ghidul arată cum pornești prin API o scanare de securitate WordPress pe un site, cum o aștepți și cum îi citești rezultatul. Folosește aceleași operații ca panoul.
De ce ai nevoie
Secțiune intitulată „De ce ai nevoie”- O cheie API cu scope-ul
wpscan:readpentru a citi rezultatele șiwpscan:writepentru a porni o scanare (scope-uri). Cheia nu poate face niciodată mai mult decât utilizatorul ei: un revânzător sau un client ajunge doar la site-urile propriilor conturi. - Id-ul site-ului. Listează site-urile unui cont cu
GET /api/v1/accounts/{account_id}/sitesși iaid-ul site-ului WordPress. - Un server al cărui agent poate scana. Dacă nu poate, sumarul arată
"supported": false, iar pornirea unei scanări răspunde409 wpscan_unsupported_agent.
export PLUSPANEL_URL="https://panel.example.com"
export PLUSPANEL_API_KEY="ppk_…"
export SITE_ID="6b6b6b6b-1111-4222-8333-444455556666"
1. Pornește o scanare
Secțiune intitulată „1. Pornește o scanare”POST /api/v1/sites/{id}/wpscan/scans pune o scanare în coadă și răspunde imediat 202; scanarea rulează mai
târziu pe server. Corpul este opțional: mode este full (implicit: verificările de integritate plus cele
de malware pe toate fișierele) sau integrity (verificarea zilnică, mai ușoară).
curl -fsS -X POST "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan/scans" \
-H "Authorization: Bearer $PLUSPANEL_API_KEY" -H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"mode": "full"}'
{
"queued": true,
"scan": {
"id": "7c7c7c7c-1111-4222-8333-444455556666",
"site_id": "6b6b6b6b-1111-4222-8333-444455556666",
"mode": "full",
"reason": "on_demand",
"state": "queued",
"requested_at": "2026-11-14T10:02:11Z"
}
}
Păstrează scan.id:
export SCAN_ID="7c7c7c7c-1111-4222-8333-444455556666"
Pe un server rulează o singură scanare o dată, deci una în coadă își poate aștepta rândul. Trimite un
Idempotency-Key, ca o reîncercare să nu pună în coadă o a doua scanare.
2. Așteaptă să se termine
Secțiune intitulată „2. Așteaptă să se termine”GET /api/v1/wpscan/scans/{id} întoarce scanarea și, după ce s-a terminat, raportul ei. Scanarea trece prin
queued, delivering și running până la o stare finală: complete, partial (terminată cu un rezultat
parțial), failed sau cancelled. Interoghează la câteva secunde, sau la un minut pentru un site mare.
until state=$(curl -fsS "$PLUSPANEL_URL/api/v1/wpscan/scans/$SCAN_ID" \
-H "Authorization: Bearer $PLUSPANEL_API_KEY" | jq -r .scan.state) \
&& case "$state" in complete|partial|failed|cancelled) true ;; *) false ;; esac; do
sleep 10
done
echo "$state"
Câmpurile utile din scan:
score(0–100) șigrade(de laAlaF), completate la sfârșitul scanării; până atunciscoreestenullșigradeeste gol.findings_totalșivulnerabilities_total: ce a găsit scanarea.started_atșifinished_at.errorșierror_codecând starea estefailed.
Istoricul scanărilor unui site este GET /api/v1/sites/{id}/wpscan/scans (cele mai noi primele; parcurgi
paginile cu limit și before, adică requested_at al ultimei scanări primite).
3. Citește sumarul
Secțiune intitulată „3. Citește sumarul”GET /api/v1/sites/{id}/wpscan este imaginea curentă a site-ului: scorul se calculează pe elementele care
sunt deschise acum, deci se schimbă când repari sau ignori ceva.
curl -fsS "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan" \
-H "Authorization: Bearer $PLUSPANEL_API_KEY" \
| jq '{scored, score, grade, scanned_at, open_findings, open_vulnerabilities, running: .running.state}'
{
"scored": true,
"score": 82,
"grade": "B",
"scanned_at": "2026-11-14T10:04:40Z",
"open_findings": { "high": 1, "low": 2 },
"open_vulnerabilities": { "critical": 1 },
"running": null
}
scoredestefalse, iarscoreestenull, până când o scanare s-a terminat complet.open_findingsșiopen_vulnerabilitiesnumără elementele deschise după severitate (info,low,medium,high,critical).last_scaneste ultima scanare terminată,runningeste cea aflată în coadă sau în desfășurare, dacă există.quarantinedșiquarantined_bytesdescriu carantina site-ului;settingsconține cele trei comutatoare de reparare automată.feed.attributionșiattributiondin răspunsul cu vulnerabilități conțin notificări pe care trebuie să le afișezi lângă înregistrările de vulnerabilități, dacă le afișezi în propriul instrument.
4. Citește constatările și vulnerabilitățile
Secțiune intitulată „4. Citește constatările și vulnerabilitățile”GET /api/v1/sites/{id}/wpscan/findings listează ce a găsit scanarea în fișierele și în baza de date a
site-ului, începând cu cele mai severe. Filtre: state (open, resolved, quarantined, ignored),
category și severity (severitatea minimă).
curl -fsS -G "$PLUSPANEL_URL/api/v1/sites/$SITE_ID/wpscan/findings" \
-H "Authorization: Bearer $PLUSPANEL_API_KEY" \
--data-urlencode "state=open" --data-urlencode "severity=medium" \
| jq '.items[] | {id, severity, category, path, component}'
O constatare are un id, o severity, o category, path (calea fișierului), component (componenta din care
face parte: kind core, plugin sau theme, cu slug și version), o state și două marcaje,
quarantinable și reinstallable, care arată ce reparații se aplică.
GET /api/v1/sites/{id}/wpscan/vulnerabilities listează vulnerabilitățile cunoscute ale nucleului, plugin-urilor
și temelor instalate, cu title, severity, cvss, cve, installed_version, fixed_in și state (open,
fixed, ignored). Primește filtrul state.
Același grup de operații și repară: actualizează o componentă, pune în carantină sau reinstalează fișiere,
ignoră un element și schimbă setările de reparare automată. Acestea cer wpscan:write; vezi
referința API, secțiunea wpscan.
| Status | Cod | Ce înseamnă |
|---|---|---|
401 |
invalid_api_key |
Cheia lipsește, a expirat sau a fost revocată. |
403 |
Cheia nu are scope wpscan, sau utilizatorul nu poate folosi site-ul. |
|
404 |
Site-ul sau scanarea nu există ori nu este vizibilă pentru tine. | |
409 |
edition_limit_reached |
Ediția Free: o scanare la cerere pe site pe zi UTC. Câmpul limit al răspunsului este wpscan_on_demand_daily. |
429 |
wpscan_rate_limited |
Pro și Enterprise: o scanare la cerere pe site la fiecare 10 minute. Retry-After spune când poți reîncerca. |
409 |
wpscan_unsupported_agent |
Agentul serverului nu suportă scanarea. |
Erorile sunt problem details: decide după code.
Evenimente
Secțiune intitulată „Evenimente”Nu se trimite niciun eveniment webhook la sfârșitul unei scanări: interoghează scanarea ca la pasul 2. Alertele
declanșate de regulile tale de alertă se trimit ca alert.firing și alert.resolved (lista
evenimentelor).
Legături utile
Secțiune intitulată „Legături utile”- Scanarea de securitate WordPress: ce se verifică, când rulează scanările și cum funcționează reparațiile.
- Referința API: fiecare operație
wpscan, cu câmpurile ei. - Convențiile API: erori, paginare, idempotență și ETag-uri.
- Autentificare și chei API: scope-uri și folosirea cheilor.