# Fokuus API-documentatie: endpoints, OpenAPI en voorbeelden

Een kleine API voor publieke informatie. Elke respons is JSON; de volledige inhoud is ook beschikbaar als Markdown.

## Endpoints

- `GET /api/v1`: beschikbare endpoints, versie en limiet.
- `GET /api/v1/organization`: bedrijfs- en contactgegevens.
- `GET /api/v1/services`: diensten met bronlinks.
- `GET /api/v1/pricing`: gepubliceerde prijzen, excl. btw.
- `GET /api/v1/search?q=website&limit=5`: zoek publieke pagina’s; maximaal 200 tekens en 20 resultaten.
- `GET /api/v1/pages?url=https://fokuus.be/`: volledige publieke pagina als Markdown.

## Voorbeeld

```
curl 'https://fokuus.be/api/v1/search?q=webshop&limit=3'
```

## Fouten en limieten

Ongeldige invoer geeft 400, onbekende routes 404 en niet-ondersteunde methodes 405. Fouten bevatten error.code, error.message en error.hint.

Elke respons draagt `RateLimit-Policy: "per-ip";q=120;w=60`: maximaal 120 verzoeken per 60 seconden per IP-adres. Niet-cachebare antwoorden tonen ook de actuele stand in `RateLimit`, met r (resterend) en t (seconden tot het venster opnieuw start). Boven de limiet krijg je 429 met `Retry-After` en een `application/problem+json`-fout; wacht minstens dat aantal seconden. Cache publieke informatie waar mogelijk en verstuur geen persoonsgegevens in zoekopdrachten.

## Versies

Het hoofdversienummer staat in het pad (`/api/v1`). Uitfasering kondigen we aan met de headers `Deprecation` en `Sunset`, minstens 90 dagen voor een versie stopt. Lees het [versie- en uitfaseringsbeleid](https://fokuus.be/docs/versioning/) .

## Beveiligde websiteformulieren

Contact, nieuwsbrief, calculator en AI-check zijn geen publieke agenttools. Hun bestaande toestemming, Turnstile en limieten blijven gelden. De publieke API geeft geen toegang tot rapporttokens of klantgegevens.

[Developerstart](https://fokuus.be/developers/)  · [OpenAPI](https://fokuus.be/openapi.json)  · [Authenticatie](https://fokuus.be/auth.md)  · [Versiebeleid](https://fokuus.be/docs/versioning/)

[Bron](https://fokuus.be/docs/) · [Agentdocumentatie](https://fokuus.be/developers/)