落とし穴
これらはすべてエラーではありません。ドキュメントで学ぶ方が、他の人の応答を解析するよりも良いです。
レスポンスに余分なフィールド _footer が含まれる
Section titled “レスポンスに余分なフィールド _footer が含まれる”無料プランおよびどのようなキーなしのリクエストは、レスポンスボディに _footer フィールドが追加されます。これは署名付きのものです。有料キーでは見えません。パーサーが余分なフィールドに厳しい場合、これが最初に失敗する原因となります。
同じリクエストの繰り返しは無料
Section titled “同じリクエストの繰り返しは無料”キャッシュウィンドウ内で同じリクエストが行われると、X-Cache: HIT が返され、このリクエストはクレジットを消費しません：レスポンスの X-Credits-Used: 0 であり、残高は戻ります。つまり、同じリクエストを繰り返してコストを測定することはできません：一度だけ支払う必要があります。
Sandboxキーは何の消費もしない
Section titled “Sandboxキーは何の消費もしない”aw_test_* は全くクレジットを消費せず、アカウントの制限にも含まれません。これは「小さなクォータ」ではなく、ゼロです。開発はこのキーで行い、aw_live_* は請求確認時に使用してください。
未知のフィールドは無視される
Section titled “未知のフィールドは無視される”ボディは余分なキーを受け入れ、それらを無視します。例外は明示的に拒否された短縮表記のみです（lat、tz など、詳細は フィールドのフォーマット を参照）。そのため、フィールド名のタイポは通常問題にならず、200 と、あなたのパラメータなしで計算された地図を受け取ります。
北極圏では住宅システムが置き換えられる
Section titled “北極圏では住宅システムが置き換えられる”四分位システムでは |latitude| > 66.5° の場合、クスピディは Porphyry と見なされます。これらのシステムはその地域で定義されていないためです。これは隠さない：レスポンスに warning フィールドが追加されます。Whole Sign と Equal はどの緯度でも動作します。
隣接するケースは拒否で閉じられています：未知の houseSystem コードは Placidus を異なる名前で提供せず、代わりに 400 を返します。
キーには3つの独立した制限がある
Section titled “キーには3つの独立した制限がある”ブラウザーキー pk_ とシークレットキー aw_ は同時に3つの制限を持つことがあり、お互いを置き換えることはありません：
| 制限 | 説明 | 拒否 |
|---|---|---|
| ドメインリスト | リクエストできる場所 | 403 ORIGIN_REQUIRED / ORIGIN_NOT_ALLOWED |
credits_cap_cycle | このキーが消費できる量 | 429 KEY_BUDGET_EXHAUSTED |
allowed_endpoints | どのエンドポイントを呼び出せるか | 403 ENDPOINT_NOT_IN_SCOPE |
エンドポイントの範囲はサービス読み取りを解放しません：embed/* に制限されたキーは、自分の統計情報すら読み取れません。これは意図的であり、詳細は 認証 を参照してください。
キーの編集は次のリクエストから有効
Section titled “キーの編集は次のリクエストから有効”キーは60秒間キャッシュされますが、どのような変更も PATCH /v1/keys/{id} を通じて行われると、キャッシュが即座にリセットされます。1分待つ必要はありません。