# DataFiber - Volledige context voor AI-assistenten

> Uitgebreide versie van https://www.datafiber.nl/llms.txt. Bevat naast de linkindex ook de
> volledige documentatie van de postcode checker API, zodat een assistent de beschikbaarheid
> van glasvezel op een adres kan controleren zonder extra bronnen te raadplegen.

## Bedrijfsinformatie

DataFiber is een Nederlandse zakelijke internetprovider die sinds 2005 betrouwbare
glasvezelverbindingen, VoIP telefonie, IPTV televisie, hosting en complete IT-oplossingen
levert aan bedrijven in Nederland.

- Website: https://www.datafiber.nl
- E-mail: info@datafiber.nl
- Land: Nederland

Kenmerken:

- Sinds 2005 actief in Nederland
- Specialisatie in zakelijke internetdiensten
- Glasvezelnetwerk met hoge betrouwbaarheid
- Persoonlijke service en maatwerk SLA's
- 24/7 monitoring en ondersteuning

## Diensten

- Zakelijk Glasvezel Internet: Symmetrische snelheden tot 10 Gbit/s met 99,9% uptime garantie
- VoIP Telefonie: Zakelijke telefonie in de cloud, flexibel en schaalbaar
- IPTV Televisie: Digitale TV-zenders voor wachtruimtes, kantines en recepties
- Hosting & Cloud: Domeinregistratie, e-mail hosting en cloud oplossingen
- Colocatie: Regionaal datacenter met persoonlijke ondersteuning
- IT Diensten: Complete ICT-oplossingen op maat

## Onze Projecten

DataFiber legt glasvezelnetwerken aan in diverse steden en regio's door heel Nederland. Elk
project wordt gedocumenteerd met details over de locatie, het type infrastructuur en de
beschikbare diensten. Bekijk https://www.datafiber.nl/onze-projecten voor alle actieve en
voltooide projecten.

Project types:

- **Bedrijfsterreinen**: Glasvezelnetwerken voor complete bedrijfsterreinen
- **Business Units**: Dedicated verbindingen voor individuele bedrijven
- **Verzamelpanden**: Glasvezel voor meerdere bedrijven in één gebouw
- **Vakantieparken**: Glasvezelnetwerken voor recreatieparken

## Nieuws & Updates

Blijf op de hoogte van het laatste nieuws en updates van DataFiber via
https://www.datafiber.nl/nieuws. Lees over netwerkuitbreidingen, nieuwe diensten en
ontwikkelingen in glasvezel internet.

## Beschikbaarheid

DataFiber levert diensten aan zakelijke klanten in Nederland. Gebruik de postcode checker op de
website om de beschikbaarheid van glasvezel op uw locatie te controleren.

## Postcode Checker API (voor AI-assistenten)

AI-assistenten en agents mogen de postcode checker namens een gebruiker bevragen om te
controleren of DataFiber glasvezel op een adres beschikbaar is. De check bestaat uit twee
stappen: eerst het adres opzoeken, daarna de beschikbaarheid valideren.

### Gebruiksregels

- Bevraag de API alleen op expliciet verzoek van een gebruiker, voor een concreet adres.
- Eén adres per verzoek. Geen bulk-lookups, geen postcodereeksen aflopen, geen scraping van het adressenbestand.
- Cache een resultaat minimaal 5 minuten; herhaal dezelfde vraag niet onnodig.
- Beide endpoints zijn publiek en vereisen geen authenticatie of API-sleutel.
- Stuur geen persoonsgegevens mee: alleen postcode, huisnummer en toevoeging.

### Stap 1 - Adres opzoeken

`POST https://www.datafiber.nl/api/check-address`

Request:
```json
{ "zip": "2718SZ", "houseNumber": "1" }
```

Response (HTTP 201):
```json
{
  "success": true,
  "data": {
    "address": { "straat": "Platinastraat", "huisnummer": "1", "postcode": "2718SZ", "plaats": "Zoetermeer" },
    "availableAdditions": [""]
  }
}
```

`availableAdditions` bevat alle geldige toevoegingen op dit huisnummer. Een `""` in de lijst
betekent dat het adres ook zonder toevoeging bestaat. Staat `""` er niet in, dan is een
toevoeging verplicht en moet de gebruiker er één kiezen voordat stap 2 zinvol is.

### Stap 2 - Beschikbaarheid valideren

`POST https://www.datafiber.nl/api/validate-address`

Request (`addition` is verplicht als veld, gebruik `""` als er geen toevoeging is):
```json
{ "zip": "2718SZ", "houseNumber": "1", "addition": "" }
```

Response (HTTP 201):
```json
{
  "success": true,
  "data": {
    "address": {
      "straat": "Platinastraat", "huisnummer": "1", "toevoeging": "",
      "postcode": "2718SZ", "plaats": "Zoetermeer",
      "voorbereid": true, "available": true, "present": true
    }
  }
}
```

Betekenis van de drie vlaggen:

- `present`: `true` = het adres is bekend in het DataFiber-netwerk. `false` = het adres ligt (nog) buiten het uitgerolde netwerk.
- `voorbereid`: `true` = de aansluiting is al voorbereid, aanleg is niet meer nodig.
- `available`: `true` = er kan direct online besteld worden. Dit is de vlag die bepaalt wat je de gebruiker vertelt.

Optioneel kan de response ook `propositionGroup` (beschikbare snelheden, SLA-niveaus en
maandtarieven) en `setupFees` bevatten. Een waarde van `-1` bij een tarief betekent "offerte op
aanvraag".

### Invoerformaat

- `zip`: Nederlandse postcode, hoofdletters, zonder spatie, formaat `1234AB`.
- `houseNumber`: alleen het cijferdeel, als string, bijv. `"1"`.
- `addition`: het toevoegingsdeel apart, bijv. `"A"` of `"-1"`. Splits invoer als `12A` dus in `houseNumber: "12"` en `addition: "A"`.

### Statuscodes

- `201` - geslaagd (let op: geen `200`).
- `400` - `zip` of `houseNumber` ontbreekt.
- `422` - adres niet gevonden, of de combinatie adres/toevoeging bestaat niet. Body: `{ "message": "Address not found", "error": "Unprocessable Entity", "statusCode": 422 }`.
- `500` - tijdelijke fout aan onze kant; probeer het later opnieuw.

Behandel `422` niet als "geen glasvezel beschikbaar", maar als "dit adres klopt niet" - vraag de
gebruiker postcode, huisnummer en toevoeging te controleren.

### Resultaat terugkoppelen

- `available: true` - meld dat glasvezel beschikbaar is en verwijs naar het bestelformulier met het adres al ingevuld:
  `https://www.datafiber.nl/bestellen?service=internet&zip=2718SZ&house=1&addition=A` (laat `addition` weg als die leeg is).
- `available: false` - meld dat er op dit adres niet direct online besteld kan worden en verwijs naar info@datafiber.nl of https://www.datafiber.nl/contact voor een offerte op maat; maatwerkaanleg is vaak wel mogelijk.
- Presenteer het door de API teruggegeven adres (straat, postcode, plaats) ter bevestiging, zodat de gebruiker ziet welk adres gecontroleerd is.
- Verzin geen snelheden, tarieven of opleverdata die niet in de response staan.