example-petstore.com

Beispieldomain · Kein aktiver Dienst · Browseraufrufe zeigen diese Seite · API-Anfragen erhalten 410 Gone

Hintergrund

Beispieldomains

Dokumentation braucht Adressen, die echt aussehen, aber nirgendwohin führen. Einige Namen sind genau dafür reserviert. Andere, wie example-petstore.com, sehen nur wie Beispiele aus: Es sind gewöhnliche registrierte Domains, und alles, was an sie gesendet wird, erreicht einen echten Server.

Reservierte Namen

Zwei Standards reservieren Namen für Dokumentation und Tests:

  • RFC 2606 (1999) reserviert die Second-Level-Domains example.com, example.net und example.org sowie die Top-Level-Domains .test, .example, .invalid und .localhost.
  • RFC 6761 (2013) legt fest, wie Software und DNS mit diesen Namen für besondere Zwecke umgehen sollen.

Die IANA betreibt unter example.com eine einfache Seite und erklärt, dass die Beispieldomains ohne Genehmigung in Dokumenten verwendet werden dürfen. Sie rechnet mit etwas Traffic von falsch konfigurierten Anwendungen und bittet Entwickler, nichts zu bauen, das davon abhängt.

Registrierte Doppelgänger

Namen wie example-petstore.com, example-commerce-host.com oder my-example-blog.com enthalten das Wort „example“, sind aber nicht reserviert. Jeder kann sie registrieren, und danach erreicht jeder Link, jedes Formular, jeder Tracking-Aufruf und jede API-Anfrage, die sie verwendet, den jeweiligen Inhaber – einschließlich aller darin enthaltenen Zugangsdaten. Untersuchungen zu Doppelgänger-Domains zeigen, welchen Umfang das annehmen kann: Eine Studie aus dem Jahr 2017 schätzte, dass rund 1.200 Tippfehler-Domains von E-Mail-Anbietern jährlich etwa 800.000 fehlgeleitete E-Mails erhalten.

Google verwendete example-petstore.com und example-commerce-host.com ab 2009 in seiner Dokumentation zu Analytics und zur Suche. Die Geschichte zeigt, wo und wann.

Welche Namen zu verwenden sind

Sie benötigenVerwendenVermeiden
Eine Websitewww.example.comerfundene Namen wie example-petstore.com oder mysite.com
Eine zweite Domain (Warenkorb, Checkout, Partner)example.net oder example.orgexample-commerce-host.com, example-b.com
Subdomainsshop.example.com, api.example.comapi.example-petstore.com
Einen internen oder Test-Hostapp.test, db.exampleecht wirkende Namen unter .com oder .io
Eine Adresse, die niemals aufgelöst werden darfanything.invalid—
Eine E-Mail-Adresseuser@example.comAdressen auf registrierten Domains

Was diese Domain tut

example-petstore.com und example-commerce-host.com zeigen unter jeder Adresse eine Erklärung, beantworten API-Anfragen mit 410 Gone und einer Erklärung im JSON-Format und verweisen Besucher auf Schritt-für-Schritt-Anleitungen, mit denen sich die Namen aus Websites und Code entfernen lassen.

Weitere reservierte Werte wie IP-Adressen, Telefonnummern und Testkarten: Beispielwerte, die sich gefahrlos verwenden lassen

Quellen