--- title: "Voorbeeldwaarden voor docs: IP’s, domeinen, telefoonnummers" description: "Gereserveerde waarden voor documentatie: voorbeelddomeinen, IP-bereiken (RFC 5737, RFC 3849), AS-nummers, MAC-adressen, telefoonnummers en testkaarten." url: https://example-petstore.com/nl/guides/example-values language: nl --- # Voorbeeldwaarden die je veilig kunt gebruiken Documentatie, tutorials en tests hebben adressen, nummers en namen nodig die echt lijken maar nooit iemand bereiken. Voor de meeste soorten waarden bestaat een gereserveerd bereik. Deze gids zet ze op een rij, telkens met de bron, zodat voorbeelden onschadelijk blijven als iemand ze kopieert. ## Waarom gereserveerde waarden Voorbeelden worden gekopieerd: naar code, configuratiebestanden, tests en andere documentatie. Een waarde die verzonnen lijkt maar van iemand is, stuurt dat verkeer, die e-mails of die telefoontjes naar een echte partij. example-petstore.com is daar een voorbeeld van: een verzonnen naam uit de documentatie van Google die iedereen kon registreren, en die nog altijd verzoeken ontvangt. Gereserveerde waarden worden gegarandeerd nooit uitgegeven, zodat een gekopieerd voorbeeld onschadelijk mislukt. ## Domeinnamen en e-mail Gebruik voor websites, API’s en e-mailadressen in voorbeelden `example.com`, `example.net` of `example.org` en hun subdomeinen, zoals `api.example.com` en `user@example.com`. Voor testomgevingen, namen die nooit mogen resolven en lokale netwerken zijn er `.test`, `.invalid`, `.localhost`, `home.arpa` en `.internal`. Waar elke gereserveerde naam voor dient, en waarom lookalikes zoals example-petstore.com niet veilig zijn: [Voorbeelddomeinen](https://example-petstore.com/nl/example-domains) ## IP-adressen | Soort | Gereserveerd voor documentatie | Bron | | --- | --- | --- | | IPv4 | `192.0.2.0/24` (TEST-NET-1), `198.51.100.0/24` (TEST-NET-2), `203.0.113.0/24` (TEST-NET-3) | RFC 5737 | | IPv6 | `2001:db8::/32` | RFC 3849 | | IPv6, grotere netwerken | `3fff::/20` | RFC 9637 (2024) | ``` # Een client, een server en een proxy in een voorbeeld client 192.0.2.10 2001:db8::10 server 198.51.100.20 2001:db8:1::20 proxy 203.0.113.30 2001:db8:2::30 ``` De drie IPv4-blokken geven een voorbeeld drie aparte “netwerken”, wat helpt bij uitleg over routering of firewalls. `3fff::/20` bestaat omdat `2001:db8::/32` te klein is om realistische toewijzingen voor grote providers te laten zien. ## AS-nummers Voor BGP-voorbeelden: `64496`–`64511` (16-bit) en `65536`–`65551` (32-bit), door RFC 5398 gereserveerd voor documentatie. AS-nummers voor privégebruik zijn bedoeld voor echte netwerken, niet voor voorbeelden. ## MAC-adressen `00-00-5E-00-53-00` tot en met `00-00-5E-00-53-FF` (in de meeste tools geschreven als `00:00:5e:00:53:00`) zijn door RFC 9542 (de opvolger van RFC 7042) gereserveerd voor documentatie. ## Telefoonnummers Een wereldwijd bereik bestaat niet; verschillende landen reserveren hun eigen nummers voor fictie en voorbeelden: - **Verenigde Staten en Canada:** `555-0100` tot en met `555-0199`, met elk netnummer, zoals `+1 202 555 0143`. - **Verenigd Koninkrijk** (Ofcom): mobiel `07700 900000` tot en met `07700 900999`, Londen `020 7946 0000` tot en met `020 7946 0999`, en `01632 960000` tot en met `01632 960999` zonder een bepaalde regio. Voor andere landen kijk je bij de telecomtoezichthouder. Bestaat er geen bereik, gebruik dan een voorbeeldwaarde die niet te bellen is, zoals `+31 6 XXXX XXXX`, in plaats van cijfers die alleen willekeurig lijken. ## Betaalkaarten Betaalproviders publiceren testkaartnummers die alleen in hun testmodus werken, zoals `4242 4242 4242 4242` van Stripe, met elke vervaldatum in de toekomst en elke CVC. Gebruik de nummers van de provider waarmee je koppelt; testnummers van de ene provider worden door een andere niet geaccepteerd. Gebruik nooit een echt kaartnummer, ook je eigen niet, in documentatie, fixtures of screenshots. ## Wat je beter niet gebruikt - **Verzonnen lookalike-domeinen** zoals example-petstore.com, mycompany.com of test.com: die kunnen geregistreerd worden, en zijn dat vaak ook. - **Privé-adresbereiken** zoals `10.0.0.0/8` of `192.168.0.0/16` in openbare documentatie: die bestaan in het eigen netwerk van de lezer, dus een gekopieerd voorbeeld kan daar een echt apparaat bereiken. - **Echt ogende API-sleutels**: schrijf een duidelijke voorbeeldwaarde zoals `YOUR_API_KEY` of `sk_test_…`, nooit een sleutel die ooit geldig was. - **Gegevens van echte mensen**: namen, e-mailadressen en telefoonnummers van collega’s of klanten horen niet in voorbeelden of testfixtures. ## Verwante gidsen ### [API-clients en SDK’s configureren](https://example-petstore.com/nl/guides/api-base-url) Houd basis-URL’s buiten de code, laat ze naar de echte dienst wijzen en voeg een controle toe die voorkomt dat voorbeeldadressen in productie belanden. ### [Test tegen een mock-API, niet tegen een voorbeeldadres](https://example-petstore.com/nl/guides/mock-api) Ontwikkel en test tegen Prism, WireMock, MSW of json-server in plaats van een adres dat van iemand anders is. ### [Op zoek naar de Swagger Petstore?](https://example-petstore.com/nl/guides/swagger-petstore) De echte basis-URL’s van de voorbeeld-API Swagger Petstore, werkende verzoeken, de testsleutel en een eigen kopie draaien met Docker. ## Bronnen - [RFC 2606: Reserved Top Level DNS Names](https://www.rfc-editor.org/rfc/rfc2606.html) IETF - [RFC 6761: Special-Use Domain Names](https://www.rfc-editor.org/rfc/rfc6761.html) IETF - [RFC 8375: Special-Use Domain home.arpa](https://www.rfc-editor.org/rfc/rfc8375.html) IETF - [Reserving .INTERNAL for private-use applications](https://www.icann.org/en/board-activities-and-meetings/materials/approved-resolutions-special-meeting-of-the-icann-board-29-07-2024-en) ICANN - [RFC 5737: IPv4 Address Blocks Reserved for Documentation](https://www.rfc-editor.org/rfc/rfc5737.html) IETF - [RFC 3849: IPv6 Address Prefix Reserved for Documentation](https://www.rfc-editor.org/rfc/rfc3849.html) IETF - [RFC 9637: Expanding the IPv6 Documentation Space](https://www.rfc-editor.org/rfc/rfc9637.html) IETF - [RFC 5398: AS Number Reservation for Documentation Use](https://www.rfc-editor.org/rfc/rfc5398.html) IETF - [RFC 9542: IANA Considerations and IETF Protocol and Documentation Usage for IEEE 802 Parameters](https://www.rfc-editor.org/rfc/rfc9542.html) IETF - [555 Line Numbers](https://www.nanpa.com/numbering/555-line-numbers) NANPA - [Telephone numbers for drama](https://www.ofcom.org.uk/phones-and-broadband/phone-numbers/numbers-for-drama) Ofcom - [Test card numbers](https://docs.stripe.com/testing) Stripe