--- title: "Valores de ejemplo para docs: IP, dominios, teléfonos" description: "Valores reservados para documentación y pruebas: dominios de ejemplo, rangos IP (RFC 5737, RFC 3849), números AS, direcciones MAC, teléfonos y tarjetas." url: https://example-petstore.com/es/guides/example-values language: es --- # Valores de ejemplo que puedes usar sin riesgo La documentación, los tutoriales y las pruebas necesitan direcciones, números y nombres que parezcan reales pero que nunca lleguen a nadie. Para la mayoría de los tipos de valor existe un rango reservado. Esta guía los reúne, cada uno con su fuente, para que los ejemplos sigan siendo inofensivos cuando alguien los copia. ## Por qué valores reservados Los ejemplos se copian: en código, archivos de configuración, pruebas y otra documentación. Un valor que parece inventado pero pertenece a alguien envía ese tráfico, esos correos o esas llamadas a un tercero real. example-petstore.com es un buen ejemplo: un nombre inventado en la documentación de Google que cualquiera podía registrar y que todavía recibe solicitudes. Los valores reservados tienen la garantía de que nunca se asignarán, así que un ejemplo copiado falla sin causar daño. ## Nombres de dominio y correo Para sitios web, API y direcciones de correo en ejemplos, usa `example.com`, `example.net` o `example.org` y sus subdominios, como `api.example.com` y `user@example.com`. Para entornos de prueba, nombres que nunca deben resolverse y redes locales existen `.test`, `.invalid`, `.localhost`, `home.arpa` y `.internal`. Para qué sirve cada nombre reservado y por qué imitaciones como example-petstore.com no son seguras: [Dominios de ejemplo](https://example-petstore.com/es/example-domains) ## Direcciones IP | Tipo | Reservado para documentación | Fuente | | --- | --- | --- | | 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, redes más grandes | `3fff::/20` | RFC 9637 (2024) | ``` # Un cliente, un servidor y un proxy en un ejemplo 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 ``` Los tres bloques IPv4 dan a un ejemplo tres “redes” separadas, lo que ayuda a explicar el enrutamiento o los cortafuegos. `3fff::/20` existe porque `2001:db8::/32` es demasiado pequeño para mostrar asignaciones realistas de grandes proveedores. ## Números AS Para ejemplos de BGP: `64496`–`64511` (16 bits) y `65536`–`65551` (32 bits), reservados para documentación por el RFC 5398. Los números AS de uso privado están pensados para redes reales, no para ejemplos. ## Direcciones MAC De `00-00-5E-00-53-00` a `00-00-5E-00-53-FF` (escritas como `00:00:5e:00:53:00` en la mayoría de las herramientas) están reservadas para documentación por el RFC 9542 (que sustituyó al RFC 7042). ## Números de teléfono No existe un rango mundial; varios países reservan el suyo para la ficción y los ejemplos: - **Estados Unidos y Canadá:** de `555-0100` a `555-0199`, con cualquier prefijo de zona, como `+1 202 555 0143`. - **Reino Unido** (Ofcom): móviles de `07700 900000` a `07700 900999`, Londres de `020 7946 0000` a `020 7946 0999`, y de `01632 960000` a `01632 960999` sin una zona concreta. Para otros países, consulta al regulador de telecomunicaciones. Si no hay ningún rango, usa un número ficticio que no se pueda marcar, como `+31 6 XXXX XXXX`, en lugar de cifras que solo parecen aleatorias. ## Tarjetas de pago Los proveedores de pago publican números de tarjeta de prueba que solo funcionan en su modo de prueba, como el `4242 4242 4242 4242` de Stripe, con cualquier fecha de caducidad futura y cualquier CVC. Usa los números del proveedor que estés integrando; otro proveedor no acepta sus números de prueba. No uses nunca un número de tarjeta real, ni siquiera el tuyo, en documentación, fixtures o capturas de pantalla. ## Qué no usar - **Dominios inventados que imitan ejemplos**, como example-petstore.com, mycompany.com o test.com: se pueden registrar, y a menudo lo están. - **Rangos de direcciones privadas** como `10.0.0.0/8` o `192.168.0.0/16` en documentación pública: existen en la propia red del lector, así que un ejemplo copiado puede llegar allí a un dispositivo real. - **Claves de API de apariencia real**: escribe un marcador claro como `YOUR_API_KEY` o `sk_test_…`, nunca una clave que haya sido válida alguna vez. - **Datos de personas reales**: los nombres, direcciones de correo y números de teléfono de compañeros o clientes no deben aparecer en ejemplos ni en fixtures de prueba. ## Guías relacionadas ### [Configurar clientes de API y SDK](https://example-petstore.com/es/guides/api-base-url) Mantén las URL base fuera del código, haz que apunten al servicio real y añade una comprobación que impida que las direcciones de ejemplo lleguen a producción. ### [Prueba con una API simulada (mock), no con una dirección de ejemplo](https://example-petstore.com/es/guides/mock-api) Desarrolla y prueba con Prism, WireMock, MSW o json-server en lugar de una dirección que pertenece a otra persona. ### [¿Buscas Swagger Petstore?](https://example-petstore.com/es/guides/swagger-petstore) Las URL base reales de la API de ejemplo Swagger Petstore, solicitudes que funcionan, la clave de prueba y cómo ejecutar tu propia copia con Docker. ## Fuentes - [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