--- title: "ドキュメント用のサンプル値: IP、ドメイン、電話番号" description: "ドキュメントとテスト用の予約値。サンプル ドメイン、IP 範囲（RFC 5737、RFC 3849）、AS 番号、MAC アドレス、電話番号、テスト用カード。" url: https://example-petstore.com/ja/guides/example-values language: ja --- # 安全に使えるサンプル値 ドキュメント、チュートリアル、テストには、本物らしく見えても決して誰にも届かないアドレス、番号、名前が必要です。ほとんどの種類の値には、予約された範囲があります。このガイドではそれらを出典とともにまとめています。誰かが例をコピーしても、害のないままにしておけます。 ## 予約値を使う理由 例はコピーされます。コード、設定ファイル、テスト、ほかのドキュメントへ。架空に見えても実は誰かのものである値は、そのトラフィック、メール、電話を実在の相手に送ってしまいます。example-petstore.com がその一例です。Google のドキュメントで使われた架空の名前で、誰でも登録でき、今もリクエストが届いています。予約値は決して割り当てられないことが保証されているため、コピーされた例は害なく失敗します。 ## ドメイン名とメール 例に出てくるウェブサイト、API、メールアドレスには、`example.com`、`example.net`、`example.org` とそのサブドメイン（`api.example.com` や `user@example.com` など）を使ってください。テスト環境、決して名前解決されてはならない名前、ローカル ネットワークには、`.test`、`.invalid`、`.localhost`、`home.arpa`、`.internal` があります。 予約済みの各名前の用途と、example-petstore.com のような類似名が安全でない理由: [サンプル ドメイン](https://example-petstore.com/ja/example-domains) ## IP アドレス | 種類 | ドキュメント用に予約 | 出典 | | --- | --- | --- | | 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（大規模ネットワーク） | `3fff::/20` | RFC 9637 (2024) | ``` # 例に登場するクライアント、サーバー、プロキシ 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 ``` 3 つの IPv4 ブロックを使うと、例の中に別々の「ネットワーク」を 3 つ用意でき、ルーティングやファイアウォールの説明に役立ちます。`3fff::/20` があるのは、`2001:db8::/32` では大手プロバイダーの現実的な割り当てを示すには小さすぎるためです。 ## AS 番号 BGP の例には、RFC 5398 でドキュメント用に予約された `64496`–`64511`（16 ビット）と `65536`–`65551`（32 ビット）を使います。プライベート用の AS 番号は実際のネットワーク向けであり、例のためのものではありません。 ## MAC アドレス `00-00-5E-00-53-00` から `00-00-5E-00-53-FF` まで（多くのツールでは `00:00:5e:00:53:00` と表記）は、RFC 9542（RFC 7042 の後継）でドキュメント用に予約されています。 ## 電話番号 世界共通の範囲はありません。いくつかの国が、フィクションや例のために独自の範囲を予約しています。 - **米国とカナダ:** `555-0100` から `555-0199` まで。市外局番は任意で、たとえば `+1 202 555 0143` のように使います。 - **英国**（Ofcom）: 携帯電話は `07700 900000` から `07700 900999` まで、ロンドンは `020 7946 0000` から `020 7946 0999` まで、特定の地域を持たないものは `01632 960000` から `01632 960999` までです。 ほかの国については、通信規制当局を確認してください。範囲がない場合は、ランダムに見えるだけの数字ではなく、`+31 6 XXXX XXXX` のようにダイヤルできないプレースホルダーを使いましょう。 ## 決済カード 決済サービスは、テストモードでのみ機能するテスト用カード番号を公開しています。たとえば Stripe の `4242 4242 4242 4242` は、将来の任意の有効期限と任意の CVC で使えます。連携する決済サービスの番号を使ってください。あるサービスのテスト番号は、別のサービスでは受け付けられません。ドキュメント、フィクスチャ、スクリーンショットには、自分のものであっても本物のカード番号を決して使わないでください。 ## 使ってはいけないもの - **架空の紛らわしいドメイン**（example-petstore.com、mycompany.com、test.com など）: 登録される可能性があり、実際に登録されていることもよくあります。 - **公開ドキュメントでのプライベート アドレス範囲**（`10.0.0.0/8` や `192.168.0.0/16` など）: 読者自身のネットワークに存在するため、コピーされた例がそこにある実際の機器に届くおそれがあります。 - **本物らしい API キー**: `YOUR_API_KEY` や `sk_test_…` のような明確なプレースホルダーを書き、一度でも有効だったキーは決して使わないでください。 - **実在の人物のデータ**: 同僚や顧客の名前、メールアドレス、電話番号を、例やテスト用フィクスチャに含めてはいけません。 ## 関連ガイド ### [API クライアントと SDK の設定](https://example-petstore.com/ja/guides/api-base-url) ベース URL をコードから切り離して実際のサービスを指すようにし、サンプルのアドレスが本番環境に届かないようチェックを追加します。 ### [サンプルのアドレスではなく Mock API でテストする](https://example-petstore.com/ja/guides/mock-api) 他人のものかもしれないアドレスではなく、Prism、WireMock、MSW、json-server を相手に開発・テストします。 ### [Swagger Petstore をお探しですか？](https://example-petstore.com/ja/guides/swagger-petstore) Swagger Petstore サンプル API の本当のベース URL、動作するリクエスト例、テスト用キー、Docker で自分のコピーを動かす方法。 ## 出典 - [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