重要なお知らせNotionにおけるセキュリティインシデントについて (調査中、影響を受けた可能性は低い見込み)お知らせ一覧 →

技術・実装

要約: APIリクエスト回数は月間・年間で制限なし(トライアル中は一部のAPIに回数制限あり)。許可ドメインを登録すればブラウザから公開キーで直接呼べます(許可ドメイン以外からのリクエストは拒否されます)。サーバーサイドやより秘匿性が必要な処理にはシークレットキーを使用します。

APIリクエスト回数の制限はありますか?この見出しへのリンク

リクエスト回数(総数)に関する制限は次のとおりです。

  • トライアル期間中: 一部のAPIに一定の回数制限があります。
  • 月間・年間のリクエスト数: 回数の制限はありません。
  • バッチAPIオプション: 逆引きAPIなど処理時間が長くなりがちなAPIでは、バッチAPIオプションで複数のリクエストを一括処理できます。

具体的な性能要件がある場合はエンタープライズプランをご検討ください。

リクエストの制限を超えてしまう際の高負荷対応は可能ですか?この見出しへのリンク

通常のプラン契約では負荷を検知してからシステムを自動拡張するため、大量のリクエストに対して初動のアクセスに対応できないことが想定されますが、事前に拡張しておくことで対応できるようにします。

事前ご申請時には、お問い合わせよりご登録のメールアドレス、実施期間、お見積り要否、ご決済手段 (クレジットカードとご請求よりご選択いただけます) をご教示ください。

ブラウザのJavaScriptから直接呼べますか?(CORS)この見出しへのリンク

はい。ダッシュボードで許可ドメインを登録するとCORSが有効になり、フロントエンドから公開キーで直接呼べます。公開キーはクライアントに配置される前提のキーで、Origin ヘッダーで利用元を許可ドメインに制限しているため、値がブラウザに現れても許可ドメイン以外からのリクエストは拒否されます。サーバーサイドで利用する場合や秘匿が必要な処理にはシークレットキーを使用し、サーバー内に厳重に保管してください。

公式SDKはありますか?この見出しへのリンク

JavaScript(TypeScript対応)と Python の公式SDKを提供しています(JavaScript SDK・Python SDK)。Ruby・PHP・Goは現時点で公式SDKはなく、curl相当のHTTPクライアントから直接呼ぶ形になります。コミュニティ製のラッパーも公開されています。

No 'Access-Control-Allow-Origin' header エラーでブラウザからAPI接続できませんこの見出しへのリンク

以下のようなエラーがブラウザのコンソールに表示される場合の対処法です。

Access to XMLHttpRequest at 'https://api.kenall.jp/v1/postalcode/1000001'
from origin 'https://<お客様の設定したドメイン>/' has been blocked by CORS policy:
No 'Access-Control-Allow-Origin' header is present on the requested resource.

レスポンスに Access-Control-Allow-Origin ヘッダがない場合、リクエスト時にアクセストークンを正しく設定していない可能性があります。リクエストヘッダの Authorization に正しいトークンが設定されているか確認してください。あわせてOriginヘッダーの設定も参考にしてください。

Originヘッダーの設定をしていてもCORSエラーが発生しますこの見出しへのリンク

www.example.com と example.com のように複数のドメインで運用していないか確認してください。ブラウザによっては www. 部分を省略して表示するため、正しいドメインを見落としている場合があります。

住所や法人名の文字を正規化したい(全角・半角・異体字など)この見出しへのリンク

住所や法人名には、全角・半角の揺れや異体字(例: 「髙」「﨑」など)、旧字体・新字体の混在といった表記の揺れが含まれることがあります。こうした文字の正規化が必要な場合は、日本語テキスト正規化ライブラリ yosina.io のご利用をおすすめします。ケンオールのAPIレスポンスと組み合わせることで、表記の揺れを吸収したうえでの比較・名寄せ・突き合わせが行えます。

他のシステムと接続するための仕様はありますか?この見出しへのリンク

REST APIを公開しています。OpenAPIスキーマ(2023-09-01/2024-01-01/2025-01-01)と、JavaScript・Python向けのSDKを提供しています。詳しくは開発用SDKをご覧ください。

同時に利用できるユーザー数に制限はありますか?この見出しへのリンク

APIサービスであるため、ユーザー数という概念はありません。同時リクエスト数には、制限を設けています。リクエスト回数については、APIリクエスト回数の制限はありますか?をご覧ください。

ディスク容量やページビューの上限はありますか?この見出しへのリンク

ケンオールは、利用者にディスク容量を割り当てるサービスではなく、ページビュー数による上限も設けていません。このため、該当する上限はありません。

入力データの形式は検証していますか?この見出しへのリンク

はい。入力データの形式を検証しています。形式が不正なリクエストには、エラーを返します。

郵便番号APIの郵便番号の型が文字列型なのはなぜですか?この見出しへのリンク

郵便番号は数字7桁ですが、0893443 のように頭がゼロの郵便番号が存在します。int型(数値型)で扱うと頭のゼロを正しく扱えないため、文字列型で取り扱うことを推奨します。

郵便番号データのレスポンスが配列になっているのはなぜですか?この見出しへのリンク

1つの郵便番号に複数の住所が紐づくケースがあるため、複数レコードを配列で返しています。「丁目を含む例」や「京都の通り名を含む例」などがこれに当たります。

関連ガイドこの見出しへのリンク

最終更新: 2026-11-05