シードとバージョンを含む再現可能なアドレス API フィクスチャ

AI要約

国、地域、要求された数、シード、およびジェネレーター データのバージョンをテストの横に保存します。アルゴリズムまたはそのソース カタログが変更される可能性がある場合、シードだけでは十分ではありません。

フィクスチャを形成するすべての入力をキャプチャします

国、地域、要求された数、シード、およびジェネレーター データのバージョンをテストの横に保存します。アルゴリズムまたはそのソース カタログが変更される可能性がある場合、シードだけでは十分ではありません。

文書に従ってプロジェクト エンドポイントを使用する

fakeloc のエンドポイントは、国、オプションの地域、数、および必要なシードを受け入れます。文書化されている最大数は 100 レコードです。合成フィクスチャを返しますが、アカウントや API キー システムはありません。個人データを送信しないでください。

curl "https://fakeloc.tech/api/addresses?country=us&count=2&seed=checkout-42&profile=false"

Response envelope: { "data": [/* two records */], "count": 2, "synthetic": true }
Each record includes generatorVersion and dataVersion; pin both with the request parameters.

アドレス API パラメータと制限 →

テストで正確な値が必要な場合にのみピン出力

フォーム コントラクト テストの場合、レコード全体のスナップショットではなく、必要なフィールドと型をアサートします。特定のエッジケースが重要な場合には正確なフィクスチャを使用し、データセットのバージョンが変更された場合には意図的にフィクスチャを更新します。

Faker シードと再現性に関するガイダンス ↗

障害を診断可能にする

機密性のないパラメータと応答のバージョンをログに記録します。結果が異なる場合は、回帰として扱う前に、まずシード エンコーディング、国のエイリアス、およびバージョンを確認してください。