--- title: "Beispielwerte für Doku: IPs, Domains, Telefonnummern" description: "Reservierte Werte für Doku und Tests: Beispieldomains, IP-Bereiche (RFC 5737, RFC 3849), AS-Nummern, MAC-Adressen, Telefonnummern und Testkarten." url: https://example-petstore.com/de/guides/example-values language: de --- # Beispielwerte, die sich gefahrlos verwenden lassen Dokumentation, Tutorials und Tests brauchen Adressen, Nummern und Namen, die echt aussehen, aber nie jemanden erreichen. Für die meisten Arten von Werten gibt es einen reservierten Bereich. Diese Anleitung listet sie mit der jeweiligen Quelle auf, damit Beispiele harmlos bleiben, wenn jemand sie kopiert. ## Warum reservierte Werte Beispiele werden kopiert: in Code, Konfigurationsdateien, Tests und andere Dokumentation. Ein Wert, der erfunden aussieht, aber jemandem gehört, schickt diesen Traffic, diese E-Mails oder diese Anrufe an eine reale Partei. example-petstore.com ist ein Beispiel dafür: ein erfundener Name aus der Dokumentation von Google, den jeder registrieren konnte und der bis heute Anfragen erhält. Reservierte Werte werden garantiert nie vergeben, sodass ein kopiertes Beispiel harmlos fehlschlägt. ## Domainnamen und E-Mail Verwenden Sie für Websites, APIs und E-Mail-Adressen in Beispielen `example.com`, `example.net` oder `example.org` und deren Subdomains, etwa `api.example.com` und `user@example.com`. Für Testumgebungen, Namen, die nie aufgelöst werden dürfen, und lokale Netze gibt es `.test`, `.invalid`, `.localhost`, `home.arpa` und `.internal`. Wofür jeder reservierte Name gedacht ist und warum Doppelgänger wie example-petstore.com nicht sicher sind: [Beispieldomains](https://example-petstore.com/de/example-domains) ## IP-Adressen | Typ | Für Dokumentation reserviert | Quelle | | --- | --- | --- | | 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, größere Netze | `3fff::/20` | RFC 9637 (2024) | ``` # Ein Client, ein Server und ein Proxy in einem Beispiel 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 ``` Die drei IPv4-Blöcke geben einem Beispiel drei getrennte „Netze“, was bei der Erklärung von Routing oder Firewalls hilft. `3fff::/20` gibt es, weil `2001:db8::/32` zu klein ist, um realistische Zuteilungen für große Provider darzustellen. ## AS-Nummern Für BGP-Beispiele: `64496`–`64511` (16 Bit) und `65536`–`65551` (32 Bit), von RFC 5398 für Dokumentation reserviert. AS-Nummern für den privaten Gebrauch sind für echte Netze gedacht, nicht für Beispiele. ## MAC-Adressen `00-00-5E-00-53-00` bis `00-00-5E-00-53-FF` (in den meisten Werkzeugen als `00:00:5e:00:53:00` geschrieben) sind durch RFC 9542 (Nachfolger von RFC 7042) für Dokumentation reserviert. ## Telefonnummern Einen weltweiten Bereich gibt es nicht; mehrere Länder reservieren eigene Nummern für Fiktion und Beispiele: - **USA und Kanada:** `555-0100` bis `555-0199` mit beliebiger Vorwahl, etwa `+1 202 555 0143`. - **Vereinigtes Königreich** (Ofcom): Mobilfunk `07700 900000` bis `07700 900999`, London `020 7946 0000` bis `020 7946 0999` und `01632 960000` bis `01632 960999` ohne bestimmte Region. Für andere Länder hilft ein Blick zur jeweiligen Telekommunikations-Regulierungsbehörde. Wo es keinen Bereich gibt, verwenden Sie einen Platzhalter, der sich nicht wählen lässt, etwa `+31 6 XXXX XXXX`, statt Ziffern, die nur zufällig aussehen. ## Zahlungskarten Zahlungsanbieter veröffentlichen Testkartennummern, die nur in ihrem Testmodus funktionieren, etwa `4242 4242 4242 4242` von Stripe mit beliebigem zukünftigem Ablaufdatum und beliebiger CVC. Verwenden Sie die Nummern des Anbieters, den Sie anbinden; Testnummern eines Anbieters werden von einem anderen nicht akzeptiert. Verwenden Sie niemals eine echte Kartennummer, auch nicht Ihre eigene, in Dokumentation, Fixtures oder Screenshots. ## Was Sie nicht verwenden sollten - **Erfundene Doppelgänger-Domains** wie example-petstore.com, mycompany.com oder test.com: Sie können registriert werden und sind es oft auch. - **Private Adressbereiche** wie `10.0.0.0/8` oder `192.168.0.0/16` in öffentlicher Dokumentation: Sie existieren im eigenen Netz der Leser, sodass ein kopiertes Beispiel dort ein echtes Gerät erreichen kann. - **Echt aussehende API-Schlüssel**: Schreiben Sie einen klaren Platzhalter wie `YOUR_API_KEY` oder `sk_test_…`, niemals einen Schlüssel, der jemals gültig war. - **Daten realer Personen**: Namen, E-Mail-Adressen und Telefonnummern von Kollegen oder Kunden gehören nicht in Beispiele oder Test-Fixtures. ## Verwandte Anleitungen ### [API-Clients und SDKs konfigurieren](https://example-petstore.com/de/guides/api-base-url) Halten Sie Basis-URLs aus dem Code heraus, lassen Sie sie auf den echten Dienst verweisen und fügen Sie eine Prüfung hinzu, die verhindert, dass Beispieladressen in die Produktion gelangen. ### [Gegen eine Mock-API testen, nicht gegen einen Platzhalter](https://example-petstore.com/de/guides/mock-api) Entwickeln und testen Sie mit Prism, WireMock, MSW oder json-server statt mit einer Adresse, die jemand anderem gehört. ### [Sie suchen den Swagger Petstore?](https://example-petstore.com/de/guides/swagger-petstore) Die echten Basis-URLs der Beispiel-API Swagger Petstore, funktionierende Anfragen, der Testschlüssel und eine eigene Kopie mit Docker. ## Quellen - [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