クイックスタート
Nihonbase — Japan Data API を数分で始められます。
認証
すべての API リクエストは API キーによる認証が必要です。X-API-Key ヘッダーにキーを含めてください:
APIキーを非公開に保つため、ブラウザのJavaScriptからではなく、サーバーからAPIを呼び出してください。
X-API-Key: YOUR_API_KEY代わりに Authorization: Bearer YOUR_API_KEY も使えます(YOUR_API_KEY は jda_… のキーであり、セッショントークンではありません)。
レート制限と料金
上限はAPIキーごとではなく、アカウント単位です。日次枠または毎分の制限を超えると HTTP 429 が返されます。
| プラン | 料金 | リクエスト/日 | リクエスト/分 |
|---|---|---|---|
| Free | 月額0円 | 100 | 10 |
| Basic | 月額1,700円 | 5,000 | 60 |
| Business | 月額4,900円 | 50,000 | 300 |
GET /health と GET /plans は枠を消費せず、APIキーも不要です。
API エンドポイント
利用できるエンドポイントを確認できます。
コード例
よく使われるプログラミング言語の例です。
curl -X GET "https://api.nihonbase.com/api/v1/prefectures" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Accept: application/json"レスポンス形式
すべてのレスポンスは、次の一貫した JSON 構造に従います:
{
"success": true,
"data": [
{
"id": 1,
"name": "Hokkaido",
"name_ja": "北海道",
"name_en": "Hokkaido",
"slug": "hokkaido",
"iso_code": "JP-01",
"region_id": 1,
"capital": "Sapporo",
"area_km2": 83424,
"population": 5224614
},
{
"id": 2,
"name": "Aomori",
"name_ja": "青森県",
"name_en": "Aomori",
"slug": "aomori",
"iso_code": "JP-02",
"region_id": 2,
"capital": "Aomori",
"area_km2": 9645,
"population": 1237984
}
],
"meta": {
"page": 1,
"limit": 50,
"total": 47
},
"error": null
}和暦変換
GET /era?date=2026-03-01 は西暦の日付(または ?year=YYYY)を和暦に変換します。元号の1年目は label_ja で元年となります。
{
"success": true,
"data": {
"gregorian_year": 2026,
"reference_date": "2026-03-01",
"era": {
"slug": "reiwa",
"name_en": "Reiwa",
"name_ja": "令和",
"year": 8,
"gannen": false,
"label_en": "Reiwa 8",
"label_ja": "令和8年"
}
},
"meta": [],
"error": null
}エラー処理
エラー時、API は次の構造のエラーレスポンスを返します:
{
"success": false,
"data": null,
"meta": {},
"error": {
"code": "RESOURCE_NOT_FOUND",
"message": "The requested resource was not found."
}
}よくあるエラーコード
| コード | HTTP ステータス | 説明 |
|---|---|---|
| API_KEY_REQUIRED | 401 | API キーがない、または無効です |
| RESOURCE_NOT_FOUND | 404 | リソースが見つかりません |
| VALIDATION_ERROR | 422 | リクエストパラメータが無効です |
| INVALID_ERA_INPUT | 422 | 和暦変換の日付または年が無効です |
| — | 429 | リクエストが多すぎます(日次枠または毎分のレート制限) |