API introductie

De Shadow Guard API stelt je in staat om programmatisch sites te beheren, scans te starten en resultaten op te vragen.

Authenticatie

Alle API requests vereisen een API key in de header:

Authorization: Bearer sg_jouw_api_key

Je maakt API keys aan via Dashboard > Instellingen > API Keys. De volledige key wordt maar eenmalig getoond.

Base URL

https://shadowguard.nl/api/agent

Endpoints

MethodeEndpointBeschrijving
POST/authAPI key valideren en capabilities ophalen
POST/scanNieuwe scan starten voor een site
GET/scansRecente scans met filters en paginering
GET/findingsFindings ophalen op severity/status
GET/configBeschikbare platformconfiguratie ophalen
POST/webhooksWebhook registreren voor events

Rate limiting

Rate limits worden per API key afgedwongen. Bij overschrijding ontvang je een 429 Too Many Requests response.

Voorbeeld

curl -X GET "https://shadowguard.nl/api/agent/scans?limit=10" \
  -H "Authorization: Bearer sg_jouw_api_key" \
  -H "Content-Type: application/json"