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
| Methode | Endpoint | Beschrijving |
|---|---|---|
| POST | /auth | API key valideren en capabilities ophalen |
| POST | /scan | Nieuwe scan starten voor een site |
| GET | /scans | Recente scans met filters en paginering |
| GET | /findings | Findings ophalen op severity/status |
| GET | /config | Beschikbare platformconfiguratie ophalen |
| POST | /webhooks | Webhook 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"