有効期限のないAPIキーの問題点
何年も前に発行され、一度もローテーションされず、今も有効なキーは、便利なものではありません。何年も誰も実際に確認していない負債です。
郵便番号検索を主要な機能として扱うべき理由
製品の優先順位は、何が最も重要かを明言するずっと前から、料金体系やドキュメントの充実度に表れます。下位の料金プランに押し込まれたエンドポイントや、看板機能の詳細なページの横で3文だけで説明されているエンドポイントは、意図したかどうかにかかわらず、社内の優先順位についての現実を伝えています。郵便番号の検索はこのパターンの典型的な犠牲者です。技術的には利用できるものの、ほとんど投資されず、完全なジオコーディングに比べて小さなユーティリティとして扱われています。
当社は、まさにそうした静かな格下げを避けるために、意図的に郵便番号の検索を他のすべてのエンドポイントと同じ料金にしました。ジオコーディング、IP検索、タイムゾーン、標高とまったく同じく、同じ1日の無料割り当ての対象となり、それを超えると同じくリクエストあたり€0.0001で課金され、同じ€50のUnlimitedキーにも含まれます。郵便番号の検索の価値が低いと示す割引プランも、その逆を示すプレミアムプランもありません。他のすべてと同じレベルに位置しているのは、そうあるべきだと当社が考えているからです。
同じ料金にすることは出発点であって、主張のすべてではありません。郵便番号の検索が一級の扱いに値するより深い理由は、その基になるデータが、他のあらゆる種類の位置データと同じくらい真剣に扱うべきものだからです。郵便制度はジオコーディングの簡易版ではありません。それ自体がひとつの構造のカテゴリーであり、形式、1つの番号がカバーする範囲の広さ、番号が行政区域とどれだけ直接対応するかが、国によって異なります。これを複数の国で正しく構築するには、本当の意味で継続的な注意が必要です。看板のジオコーディング機能が、重要なものだと思われているために当然のように受けているのと同じ種類の注意です。
エンドポイントを一級として扱うということは、ドキュメントも同じ水準にするということでもあります。実際の例、どのようなデータがどのような構造で返されるかの明確な説明、そして漠然とした包括的な主張ではなく、国ごとのカバレッジの制限についての誠実な注記です。単純だと思われてドキュメントが薄いエンドポイントは、まさに重要な点において単純なままになりがちです。どこが不十分かに気づくほど注意深く見ている人がいないからです。
これには、エンジニアリングの注意を公平に配分するということ以上の実際的な利点があります。送料計算、税務管轄の確認、サービス提供エリアの検証など、多くの現実のアプリケーションは、番地レベルの完全なジオコーディングよりも、郵便番号を正しく解決できることにより直接依存しています。郵便番号の検索をジオコーディングに比べて小さな機能として扱うのは、このデータを最も必要とするアプリケーションにとって、実際の依存関係を逆にとらえていることになります。同じ料金と同じドキュメントを与えることは、象徴的なジェスチャーではありません。業界の大半が検証しないまま受け継いできたカテゴリーの誤りを正すことに近いのです。