無料の郵便番号検索APIのレスポンススピード比較

使用したツール#

• wrk: 高負荷テストツールを使用して、各 API のレスポンススピードを計測しました。

計測条件#

• テスト対象の URL：
  • ポストくん API: https://postcode.teraren.com/postcodes/1600023.json
  • ZipCloud API: https://zipcloud.ibsnet.co.jp/api/search?zipcode=1600023
  • ttskch/jp-postal-code-api: https://jp-postal-code-api.ttskch.com/api/v1/1600023.json
• テスト時間：10 秒
• スレッド数：2
• 接続数：10

テスト内容#

各 API に対して 10 秒間リクエストを送り、以下の指標を計測しました：

• 平均レイテンシー（1 リクエストの平均応答時間）
• リクエスト数/秒（1 秒間に処理できたリクエスト数）
• データ転送量/秒

ポストくん API#

Running 10s test @ https://postcode.teraren.com/postcodes/1600023.json
  2 threads and 10 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency    17.38ms    3.50ms  56.86ms   81.09%
    Req/Sec   287.60     22.71   343.00     79.00%
  5757 requests in 10.06s, 11.29MB read
Requests/sec:    572.01
Transfer/sec:      1.12MB

ZipCloud API#

Running 10s test @ https://zipcloud.ibsnet.co.jp/api/search?zipcode=1600023
  2 threads and 10 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency   217.51ms   21.91ms 349.86ms   94.29%
    Req/Sec    22.67      8.09    40.00     78.01%
  455 requests in 10.10s, 101.51KB read
Non-2xx or 3xx responses: 404
Requests/sec:     45.07
Transfer/sec:     10.05KB

ttskch/jp-postal-code-api#

❯ wrk 'https://jp-postal-code-api.ttskch.com/api/v1/1600023.json'
Running 10s test @ https://jp-postal-code-api.ttskch.com/api/v1/1600023.json
  2 threads and 10 connections
  Thread Stats   Avg      Stdev     Max   +/- Stdev
    Latency    21.87ms   13.82ms 241.38ms   97.74%
    Req/Sec   239.94     24.27   272.00     87.00%
  4801 requests in 10.05s, 7.99MB read
Requests/sec:    477.52
Transfer/sec:    813.56KB

パフォーマンスの違い#

計測結果から、ポストくん API が最も高速であることが分かります。ttskch/jp-postal-code-api は 2 番目に高いパフォーマンスを示し、ZipCloud API は最も遅い結果となりました。

• 平均レイテンシー: ポストくん API が最も短く、次いで ttskch/jp-postal-code-api、ZipCloud API の順です。ZipCloud API は他の 2 つの API と比較して約 10 倍以上のレイテンシーがあります。

• リクエスト数/秒: ポストくん API が最も多く、ttskch/jp-postal-code-api がそれに続きます。ZipCloud API は他の 2 つの API と比較して著しく少ないリクエスト処理能力を示しています。

• データ転送量/秒: ポストくん API が最も多く、次いで ttskch/jp-postal-code-api、ZipCloud API の順です。

• エラーレスポンス: ポストくん API と ttskch/jp-postal-code-api は非 2xx/3xx レスポンスがなく、安定性が高いことが示されています。一方、ZipCloud API ではエラーが発生しており、信頼性に課題があることが示唆されます。

利用シナリオ別の選択肢#

• 高速性と安定性が最優先の場合: ポストくん API が最適です。
• 高速性は重要だが、ポストくん APIほどの極限的なパフォーマンスが不要な場合: ttskch/jp-postal-code-api も良い選択肢となります。
• 低頻度のアクセスや簡易な利用の場合: ZipCloud API も検討可能ですが、エラー処理の実装が必要です。

アクセスブロックに関して#

ポストくんでは Cloudflare の CDN によるキャッシングを行っており、不正アクセス対策も行われています。今回の 10 秒間で 6000 リクエスト近いリクエストを送っても不正判定はされませんでした。 ZipCloud では大量アクセスに対して、rate limit が早期に掛かる可能性があります。