example-petstore.com

Dominio de ejemplo · No es un servicio activo · Las visitas desde el navegador muestran esta página · Las solicitudes a la API reciben 410 Gone

Contexto

Dominios de ejemplo

La documentación necesita direcciones que parezcan reales pero no lleven a ninguna parte. Algunos nombres están reservados precisamente para eso. Otros, como example-petstore.com, solo parecen ejemplos: son dominios registrados normales, y todo lo que se les envía llega a un servidor real.

Nombres reservados

Dos estándares reservan nombres para documentación y pruebas:

  • RFC 2606 (1999) reserva los dominios de segundo nivel example.com, example.net y example.org, y los dominios de primer nivel .test, .example, .invalid y .localhost.
  • RFC 6761 (2013) establece cómo deben tratar el software y el DNS estos nombres de uso especial.

IANA mantiene una página sencilla en example.com e indica que los dominios de ejemplo se pueden usar en documentos sin pedir permiso. Espera algo de tráfico de aplicaciones mal configuradas y pide a los desarrolladores que no creen nada que dependa de él.

Imitaciones registradas

Nombres como example-petstore.com, example-commerce-host.com o my-example-blog.com contienen la palabra “example”, pero no están reservados. Cualquiera puede registrarlos, y entonces cada enlace, formulario, llamada de seguimiento o solicitud a la API que los use llega a ese propietario, incluidas las credenciales que contenga. La investigación sobre dominios parecidos muestra cuánto puede ser: un estudio de 2017 descubrió que los dominios con errores tipográficos de proveedores de correo populares recibían cientos de miles de correos mal dirigidos al año.

Google usó example-petstore.com y example-commerce-host.com en su documentación de Analytics y de la Búsqueda a partir de 2009. La historia indica dónde y cuándo.

Qué nombres usar

NecesitasUsaEvita
Un sitio webwww.example.comnombres inventados como example-petstore.com o mysite.com
Un segundo dominio (carrito, pago, socio)example.net o example.orgexample-commerce-host.com, example-b.com
Subdominiosshop.example.com, api.example.comapi.example-petstore.com
Un host interno o de pruebasapp.test, db.examplenombres de apariencia real en .com o .io
Una dirección que nunca debe resolverseanything.invalid—
Una dirección de correo electrónicouser@example.comdirecciones en dominios registrados

Qué hace este dominio

example-petstore.com y example-commerce-host.com muestran una explicación en todas las direcciones, responden a las solicitudes a la API con 410 Gone y una explicación en JSON, y dirigen a los visitantes a guías paso a paso para eliminar estos nombres de sus sitios y su código.

Fuentes