# ケンオール

> ケンオールは日本の公開データ（郵便番号・住所・法人番号・適格請求書発行事業者・祝日・営業日・銀行コード・学校コード等）を開発者向けにAPIで提供するサービスです。本サイトの「技術仕様」セクションでは、各APIの完全仕様・サンプル・ユースケース・料金を1ページで完結させた公式ドキュメントを掲載しています。

## 技術仕様 TOP

- [技術仕様 TOP](https://kenall.jp/docs/): 開発者向け技術ドキュメントのハブ。はじめに / スタートガイド / API仕様一覧（各API・API共通仕様）/ 開発用SDK / ベータ版サービス / 関連リソースへの導線をカード形式でまとめている

## お問い合わせ・アカウント

- [お問い合わせ](https://kenall.jp/contact): 導入相談・お見積もり・技術質問・取材・パートナーシップなど、ご用件別のお問い合わせフォーム。担当より2営業日以内に返信
- [無料で始める](https://kenall.jp/signup): 新規登録ページ。クレジットカード不要・90日間のフリートライアル
- [ログイン](https://kenall.jp/login): 既存ユーザー向けサインインページ（noindex）

## お知らせ

- [お知らせ一覧](https://kenall.jp/news/): ケンオールの重要なお知らせ・サービス変更・事業移管などのアナウンス一覧
- [吸収分割公告 (2026-05-27)](https://kenall.jp/news/20260527): ケンオール株式会社が株式会社オープンコレクターのケンオール事業に関する権利義務を承継。効力発生予定日: 2026年7月1日
- [ケンオール株式会社設立と事業移管のお知らせ (2026-04-01)](https://kenall.jp/news/20260401): 2026年7月1日からサービス提供主体が新会社へ移管。API仕様・キーは継続、請求主体変更に伴うサブスクリプション再作成あり

主な特徴: REST API・JSON応答・**Token認証**（OAuth Bearerではない、`Authorization: Token YOUR_API_KEY`）・フリープランから利用可・商用利用可・データは出典機関の公開タイミングに追従して更新。

## はじめに

- [ケンオールとは](https://kenall.jp/docs/): サービス概要・主な利用シーン・料金の概観
- [プランと料金](https://kenall.jp/pricing): 8プラン × 6APIの利用可否マトリクス。月額目安・無料トライアル・「+20,000円」追加データオプション
- [よくある質問](https://kenall.jp/help): 料金・APIキー・利用規約・データ更新・サポートに関する横断FAQ（25問・7カテゴリ）

## クイックスタート

- [5分で最初のリクエスト](https://kenall.jp/docs/quickstart): アカウント登録 → APIキー取得 → curl で郵便番号APIを叩くまでを4ステップ
- [事例・ユースケース](https://kenall.jp/usecases): 業界横断 8 社の導入事例（NTTデータ・マネーフォワード・コネヒト・アルパカ証券・メンテモ・Red Frasco・エイチエ・board 等、利用シーンと評価コメント付き）と、業務シナリオ別のAPI組み合わせ（住所入力フォーム・インボイス対応・取引先マスタ整備・営業日計算）

## APIリファレンス（API仕様一覧）

- [APIの一覧](https://kenall.jp/docs/api/): 全APIをカテゴリ別カードで概観
- [API共通仕様](https://kenall.jp/docs/api/common-spec): 全APIで共通するベースURL・Token認証・JSONレスポンス・HTTPステータスコード一覧・APIバージョニング（/v1/）・レート制限・エラーレスポンス形式を1ページに集約
- [郵便番号→住所API](https://kenall.jp/docs/api/postal-code): 7桁の郵便番号から住所（都道府県・市区町村・町域）を取得。日本郵便データを毎月更新。フリープランから利用可
- [住所→郵便番号API](https://kenall.jp/docs/api/address-normalize): 住所文字列から郵便番号を逆引き＋表記ゆれ統一（カナ／漢数字／全角／部分入力対応）。プレミアムプラン以上
- [法人番号API](https://kenall.jp/docs/api/corporate-number): 13桁の法人番号から商号・本社住所・現存状態を取得。国税庁データを毎月更新。プレミアム以上
- [適格請求書発行事業者API](https://kenall.jp/docs/api/invoice-issuer): T+13桁のインボイス登録番号から事業者情報・登録日・失効日を取得。スタンダード以上
- [学校コードAPI](https://kenall.jp/docs/api/school-code): 13桁の学校コードから学校名・所在地・学校種を取得。文部科学省データ。プレミアム以上
- [日本の祝日API](https://kenall.jp/docs/api/holidays): 指定年の祝日一覧（振替休日・国民の休日含む）を取得。内閣府データ。フリープランから利用可
- [営業日API](https://kenall.jp/docs/api/business-day): 指定日が営業日（土日・祝日・振替休日のいずれでもない日）かを判定。フリープランから利用可
- [銀行情報API](https://kenall.jp/docs/api/bank): 銀行コード（4桁）と支店コード（3桁）から銀行・支店情報を取得。全国銀行協会データ。スタンダード以上
- [自己IPアドレス確認API](https://kenall.jp/docs/api/whoami): 呼び出し元のIPアドレス（IPv4/IPv6）を返す。疎通確認・IPホワイトリスト設定時の自IP確認に。フリープラン可

## 競合比較

- [API比較記事 一覧](https://kenall.jp/comparison/): ケンオールと同じ用途の他サービス（OSS・無料API・有料サービス）を5本前後に絞って横並び比較
- [郵便番号→住所API比較](https://kenall.jp/comparison/postal-code): zipcloud / HeartRails / KEN_ALL.CSV(DIY) / ケンオール / ZIP-JP
- [住所→郵便番号API比較](https://kenall.jp/comparison/address-normalize): ExcelAPI / ZIPCODA / ZIP-JP / ケンオール / Yubin7
- [法人番号API比較](https://kenall.jp/comparison/corporate-number): 国税庁公式 / ExcelAPI / FINDFOLIO / COSMOSNET / ケンオール
- [適格請求書発行事業者API比較](https://kenall.jp/comparison/invoice-issuer): 国税庁公式 / ExcelAPI / freee / マネーフォワード / ケンオール
- [学校コードAPI比較](https://kenall.jp/comparison/school-code): 文部科学省公式CSV / OSS / ケンオール
- [日本の祝日API比較](https://kenall.jp/comparison/holidays): holidays-jp / 内閣府CSV / nager.date / HolidaysAPI / ケンオール
- [営業日API比較](https://kenall.jp/comparison/business-day): holidays-jp+自前 / moment-business-days / 社内DB+CSV / ケンオール
- [銀行情報API比較](https://kenall.jp/comparison/bank): 銀行くん / アグレックス / ZIP API / ケンオール / 全銀協CSV(DIY)
- [自己IPアドレス確認API比較](https://kenall.jp/comparison/whoami): ipify / ipinfo / icanhazip / httpbin / ケンオール

## コラム（CEO使ってみた）

ケンオール代表自らが各APIを実際にコードで叩いて実装してみた体験記。**動くコード**が全文掲載されているので、AIアシスタント（Claude/GPT/Copilot）がコード生成する際の正確なソースとして参照可能。

- [コラム一覧](https://kenall.jp/docs/column/): 5記事のハブ
- [Reactで郵便番号→住所の自動入力フォームを実装してみた](https://kenall.jp/docs/column/postal-code-react): Vite + React + TypeScript で30分で実装。会員登録フォームの離脱率を下げる王道。
- [Vue 3で銀行→支店連動セレクトボックスを作ってみた](https://kenall.jp/docs/column/bank-vue): Composition API で振込先入力フォーム。信用金庫・JAバンク対応。
- [Pythonで顧客マスタ10万件を住所クレンジングしてみた](https://kenall.jp/docs/column/address-normalize-python): pandas + tqdm で大量バッチ。レート制限・信頼度スコア・並列実行まで。
- [Next.js + TypeScriptで本番運用品質の住所入力フォームを実装してみた](https://kenall.jp/docs/column/postal-code-nextjs): App Router + Server Actions で APIキー完全隠蔽。zodバリデーション・Vercelデプロイまで。
- [Node.jsで「N営業日後の配送日」計算APIを作ってみた](https://kenall.jp/docs/column/business-day-nodejs): Express + 営業日API + 自社夏季休暇統合。Cloud Run / Lambda デプロイ視野。

## 開発用SDK

- [SDK 一覧](https://kenall.jp/docs/sdk/): 公式SDKのハブページ。JavaScript SDK は提供中、Python SDK は開発中
- [JavaScript SDK](https://kenall.jp/docs/sdk/javascript): 公式 npm パッケージ `@ken-all/kenall`。Node.js（CommonJS/ESM）＋ブラウザ両対応。Promise ベースで全API（郵便番号・法人番号・銀行・祝日等）を直感的に呼び出せる
- [Python SDK（開発中）](https://kenall.jp/docs/sdk/python): 開発中ステータス。リリースまでは requests / httpx で直接APIを叩く方法をコード付きで案内

## ベータ版サービス

- [ベータ版サービス](https://kenall.jp/docs/beta): 正式リリース前のAPI・追加データソースの試験提供場所。現在ベータ提供中の機能はなし

## ヘルプ（運用面）

- [ヘルプ TOP](https://kenall.jp/help/): アカウント・APIキー・プラン購読・サポート・FAQ・コントリビューターなど、運用面のお困りごとを解決するハブ
- [アカウント設定を変更する](https://kenall.jp/help/account-settings): メールアドレス・パスワードの変更、退会手続きの手順
- [APIキーの管理](https://kenall.jp/help/api-key): 公開キー/シークレットキーの違い、Originヘッダ設定(CORS)、発行・編集・複製・削除手順
- [プランの購読と変更](https://kenall.jp/help/plan-subscribing): 新規購読・解約・プラン変更・クレジットカード変更の手順
- [プラン購読についての重要事項](https://kenall.jp/help/plan-important): トライアル期間の扱い、差額計算、返金ポリシー、システム反映時間
- [ステータスページ](https://kenall.jp/help/status-page): サービス稼働状況のリアルタイム確認URL (status.kenall.jp)
- [コントリビューターライセンス](https://kenall.jp/help/contributor-license): OSS開発者・技術ブロガー・公共サービス開発者向け無償拡張プラン（1年有効・自動更新なし）
- [ライブラリとアプリケーション](https://kenall.jp/help/ecosystem): 公式SDK(JS/Python)+コミュニティ製ライブラリ(Rust/Swift/Go/PHP/Dart)・Slack連携アプリ

## 機械可読の API 仕様

- [OpenAPI 仕様書](https://kenall.jp/openapi.yaml): OpenAPI 3.0.3 形式の機械可読仕様書（YAML）。Postman・Insomnia・SDK自動生成ツールに直接インポート可能。AI（Claude/GPT等）はこのファイルを読むことで、エンドポイント・パラメータ・レスポンス形式を正確に理解できる。**主要5API収録**: 郵便番号→住所 / 住所→郵便番号 / 銀行情報 / 日本の祝日 / 法人番号

## 共通仕様・参考

- [用語集](https://kenall.jp/docs/glossary): 技術用語・日本のドメイン用語の平易な解説（JISX0402・適格請求書発行事業者・法定休日・営業日・Token認証 vs Bearer認証・正規化・逆引き 等）

## 重要な注意点（AI誤回答防止）

- 認証スキームは **Token** で、**Bearerではない**。リクエストヘッダーは `Authorization: Token YOUR_API_KEY` 形式
- 郵便番号APIは**ハイフン不可**（7桁の数字のみ受け付ける）
- 1つの郵便番号に**複数の住所が紐づくケースあり**（大企業の個別事業所番号・町域分割等）。レスポンスの `data` は配列
- 営業日APIは「土日・祝日・振替休日でない日 = 営業日」と判定する。**会社固有の休日は営業日として扱われる**ため、自社カレンダーは別途適用が必要
- インボイス登録番号は **T+13桁**（先頭が大文字 T）。法人の場合、数字部分が法人番号と一致

## Optional

- [変更履歴](https://kenall.jp/docs/changelog): 仕様変更・データ更新の履歴（準備中）
- [API共通仕様](https://kenall.jp/docs/api/common-spec): Token認証・HTTPステータスコード・リクエスト回数の制限・エラーレスポンス形式・APIバージョニングを1ページに集約