example-petstore.com

示例域名 · 并非真实服务 · 浏览器访问显示此页面 · API 请求返回 410 Gone

背景知识

示例域名

文档需要一些看起来真实、但实际上不指向任何地方的地址。有些名称正是为此而保留的。另一些名称(例如 example-petstore.com)只是看起来像示例:它们是普通的已注册域名,发送给它们的任何内容都会到达一台真实的服务器。

保留名称

有两项标准为文档和测试保留了名称:

  • RFC 2606(1999 年)保留了二级域名 example.com、example.net 和 example.org,以及顶级域名 .test、.example、.invalid 和 .localhost。
  • RFC 6761(2013 年)规定了软件和 DNS 应如何处理这些特殊用途名称。

IANA 在 example.com 上运行一个简单的页面,并声明示例域名可以在文档中使用,无需申请许可。IANA 预计会有一些来自配置错误的应用的流量,并要求开发者不要构建任何依赖于该页面的功能。

已注册的形似名称

example-petstore.com、example-commerce-host.com 或 my-example-blog.com 之类的名称虽然包含“example”一词,但并未被保留。任何人都可以注册它们,此后所有使用这些名称的链接、表单、跟踪调用或 API 请求都会到达注册者那里,其中携带的凭据也不例外。针对形似域名的研究表明了这类流量可能有多大:2017 年的一项研究估计,电子邮件服务商的约 1,200 个拼写错误域名每年会收到约 80 万封误投的电子邮件。

从 2009 年起,Google 在其 Analytics 和 Search 文档中使用了 example-petstore.com 和 example-commerce-host.com。历史页面列出了具体的位置和时间。

应使用哪些名称

您需要请使用请避免
一个网站www.example.com虚构的名称,例如 example-petstore.com 或 mysite.com
第二个域名(购物车、结账、合作伙伴)example.net 或 example.orgexample-commerce-host.com、example-b.com
子域名shop.example.com、api.example.comapi.example-petstore.com
内部主机或测试主机app.test、db.example.com 或 .io 下看起来真实的名称
绝不能被解析的地址anything.invalid—
电子邮件地址user@example.com已注册域名下的地址

此域名的作用

example-petstore.com 和 example-commerce-host.com 在每个地址上都显示一份说明,以 410 Gone 和 JSON 格式的说明响应 API 请求,并为访问者提供分步指南,帮助他们从自己的网站和代码中删除这些名称。

更多保留值,例如 IP 地址、电话号码和测试卡: 可以放心使用的示例值

来源