サービス障害のご報告 (2026年11月21日)
平素よりケンオールをご利用いただきまして誠にありがとうございます。
日本時間の2026年11月21日13時38分ごろから15時05分ごろまで、郵便番号API、住所→郵便番号API (郵便番号逆引きAPI) など郵便番号データを利用するAPIにおいて、過去のデータバージョンを version パラメータで指定したリクエストに対して、404エラーを返す事象が発生しておりました。当該事象は同日15時05分ごろに解消しております。
この度は大変ご迷惑をおかけし、誠に申し訳ございませんでした。対応の経緯および原因について、技術的な内容も含めてご報告いたします。
障害の詳細この見出しへのリンク
発生していた時間この見出しへのリンク
- 開始: 2026年11月21日 13時38分ごろ (日本時間)
- 終了: 2026年11月21日 15時05分ごろ (日本時間)
- 影響時間: 約1時間27分間
影響範囲この見出しへのリンク
version パラメータに最新以外のデータバージョンを指定して、郵便番号データを利用するAPIをご利用のお客様が影響を受けております。
- 影響のあった箇所: 次のAPIのうち、
versionに過去のデータバージョンを指定したリクエスト- 郵便番号API (
GET /v1/postalcode/{郵便番号}) - 住所→郵便番号API (
GET /v1/postalcode/?q=...およびPOST /v1/postalcode/) - 住所→郵便番号のバッチAPI (
POST /v1/batch/postalcode/search) - 市区町村一覧 (
GET /v1/cities/{都道府県コード}) - 郵便番号の更新情報 (
GET /v1/postalcode/updates/)
- 郵便番号API (
- 影響のなかった箇所:
versionを指定しないリクエスト、および最新のデータバージョンを指定したリクエスト- 法人番号API、銀行・支店API、適格請求書発行事業者API、祝日API、学校コードAPIなど、郵便番号以外のAPI
- Webページ、ダッシュボード
事象の内容この見出しへのリンク
影響範囲に合致するリクエストに対し、本来は指定されたデータバージョンでの結果を返すべきところ、ステータスコード404の応答を返しておりました。タイムアウトではなく即座にエラーを返す挙動であったため、リトライを行っても同様に失敗する状況でした。
なお、当該時間帯も、利用可能なバージョンの一覧 (/v1/postalcode/versions/) には、指定できなくなっていた過去のデータバージョンが含まれておりました。
時系列での経過この見出しへのリンク
| 時刻 (日本時間) | 内容 |
|---|---|
| 2026年11月21日 12時51分 | 定期的なリリースの本番環境への適用を開始 |
| 2026年11月21日 13時38分 | リリースの適用が完了。データバージョン指定のリクエストを処理するサーバーが入れ替わり、過去のデータバージョンを指定した、郵便番号データを利用するAPIへのリクエストが404エラーを返し始める |
| 2026年11月21日 14時20分 | 事象を検知し、調査を開始 |
| 2026年11月21日 14時37分 | 原因を特定し、修正を作成 |
| 2026年11月21日 14時43分 | 修正の本番環境への適用を開始 |
| 2026年11月21日 15時05分 | 修正の適用が完了し、事象の解消を確認 |
発生原因この見出しへのリンク
- サーバーの起動時に読み込むデータを減らす変更に不備がありました。過去のデータバージョンについて、最新のデータに含まれる索引で代替できるファイルの読み込みを省く変更を11月に行っておりましたが、サーバーは、このファイルを省いたデータバージョンを利用可能なものとして認識できなくなっておりました。
- この不備は、過去のデータバージョンすべてについて索引の整備が完了するまで表面化しない性質のものでした。整備の完了後、最初にサーバーを入れ替えた今回のリリースで初めて発生しております。
- 変更時のテストが、読み込みを省くことの確認にとどまり、省いた後もそのデータバージョンを指定したリクエストに応答できることを確認しておりませんでした。
- リリース後の動作確認および監視の対象に、過去のデータバージョンを指定したリクエストが含まれておらず、検知が遅れました。
セキュリティに関する影響この見出しへのリンク
本事象は、本来応答すべきリクエストにエラーを返したものであり、お客様のデータの外部への流出、第三者による不正なアクセス、およびデータの改ざんは発生しておりません。弊社の基準においてもセキュリティインシデントには該当しないものと判断しております。
再発防止策この見出しへのリンク
以下の対応を進めてまいります。
- 郵便番号データを利用する各APIについて、過去のデータバージョンを指定したリクエストを、リリース後の動作確認および外形監視の対象に加えます。
- サーバーが読み込んだデータについて、利用可能なバージョンの一覧と、実際にリクエストに応答できるデータバージョンが一致していることを確認する仕組みを設けます。
- 起動時に読み込むデータを変更する際は、変更後も対象のすべてのAPIが各データバージョンで応答できることをテストで確認します。
今後も同様の事象が発生しないよう、開発および運用体制の改善に努めてまいります。この度はご迷惑をおかけし、重ねてお詫び申し上げます。
← お知らせ一覧に戻る