example-petstore.com

Voorbeelddomein · Geen echte dienst · Bezoekers met een browser zien deze pagina · API-verzoeken krijgen 410 Gone

Achtergrond

Voorbeelddomeinen

Documentatie heeft adressen nodig die echt lijken maar nergens heen leiden. Sommige namen zijn precies daarvoor gereserveerd. Andere, zoals example-petstore.com, lijken alleen op voorbeelden: het zijn gewone geregistreerde domeinen, en alles wat ernaartoe wordt gestuurd, komt op een echte server terecht.

Gereserveerde namen

Twee standaarden reserveren namen voor documentatie en tests:

  • RFC 2606 (1999) reserveert de tweedeniveaudomeinen example.com, example.net en example.org, en de topleveldomeinen .test, .example, .invalid en .localhost.
  • RFC 6761 (2013) legt vast hoe software en DNS met deze namen voor speciaal gebruik omgaan.

IANA houdt een eenvoudige pagina op example.com in de lucht en vermeldt dat de voorbeelddomeinen zonder toestemming in documenten gebruikt mogen worden. IANA rekent op wat verkeer van verkeerd geconfigureerde toepassingen en vraagt ontwikkelaars niets te bouwen dat ervan afhangt.

Geregistreerde lookalikes

Namen als example-petstore.com, example-commerce-host.com of my-example-blog.com bevatten het woord “example”, maar ze zijn niet gereserveerd. Iedereen kan ze registreren, en daarna komt elke link, elk formulier, elke trackingaanroep en elk API-verzoek dat ze gebruikt bij die eigenaar terecht, samen met alle toegangsgegevens erin. Onderzoek naar lookalike-domeinen laat zien hoeveel dat kan zijn: een studie uit 2017 stelde vast dat typfoutdomeinen van populaire e-mailproviders honderdduizenden verkeerd bezorgde e-mails per jaar ontvingen.

Google gebruikte example-petstore.com en example-commerce-host.com vanaf 2009 in zijn documentatie over Analytics en Search. De geschiedenis vermeldt waar en wanneer.

Welke namen je gebruikt

Je hebt nodigGebruikVermijd
Een websitewww.example.comverzonnen namen zoals example-petstore.com of mysite.com
Een tweede domein (winkelwagen, afrekenpagina, partner)example.net of example.orgexample-commerce-host.com, example-b.com
Subdomeinenshop.example.com, api.example.comapi.example-petstore.com
Een interne host of testhostapp.test, db.exampleecht ogende namen onder .com of .io
Een adres dat nooit mag resolvenanything.invalid—
Een e-mailadresuser@example.comadressen op geregistreerde domeinen

Wat dit domein doet

example-petstore.com en example-commerce-host.com tonen op elk adres een uitleg, beantwoorden API-verzoeken met 410 Gone en een toelichting in JSON, en verwijzen bezoekers naar stap-voor-stapgidsen om de namen uit hun sites en code te verwijderen.

Bronnen