都道府県の一覧はどう取得しますか？

GET https://apis-cloud.net/prefectures/all で全47件がJSONで返ります。1件だけ欲しいときは /prefectures/random、ID を指定するときは /prefectures/{code} を使います。

都道府県APIに認証は必要ですか？

不要です。API キーもトークンもなく、GET するだけで使えます。CORS も全オリジンに開けているのでブラウザから直接呼べます。

都道府県APIにはどんなフィールドがありますか？

code、name、kana、romaji、capital、capitalRomaji、region、area、population、isoCode の 10 個です。?fields= で必要な列だけに絞れます。検索は name、kana、romaji、capital、capitalRomaji、region が対象です。

都道府県API

日本の47都道府県。人口は令和2年（2020年）国勢調査、面積は国土地理院の全国都道府県市区町村別面積調（km²）。

エンドポイント	`https://apis-cloud.net/prefectures`
件数	47 件
形式	JSON（UTF-8）
認証	不要（CORS 全オリジン許可）
ID フィールド	`code`（`name` `romaji` `isoCode` でも引ける）
検索対象	`name` `kana` `romaji` `capital` `capitalRomaji` `region`

リクエスト

curl -s "https://apis-cloud.net/prefectures/01"

const res = await fetch("https://apis-cloud.net/prefectures/01");
const data = await res.json();

import urllib.request, json

with urllib.request.urlopen("https://apis-cloud.net/prefectures/01") as r:
    data = json.load(r)

レスポンス 200 OK

{
  "code": "01",
  "name": "北海道",
  "kana": "ほっかいどう",
  "romaji": "Hokkaido",
  "capital": "札幌市",
  "capitalRomaji": "Sapporo",
  "region": "北海道",
  "area": 83424,
  "population": 5224614,
  "isoCode": "JP-01"
}

エンドポイント

都道府県APIは、他のリソースと同じ共通の形をしている。パラメータの詳しい説明は共通エンドポイントの節にある。

GET`/prefectures`	メタ情報（件数・フィールド・エンドポイント）

GET`/prefectures/all`	全47件

GET`/prefectures/random`	ランダムに1件

GET`/prefectures/search?q=北海`	部分一致検索

GET`/prefectures/fields`	フィールド名の一覧

GET`/prefectures/getCode`	code の列だけ取り出す

GET`/prefectures/01`	ID 指定で1件

GET`/prefectures/01/name`	1件の特定フィールド

全件取得

curl -s "https://apis-cloud.net/prefectures/all?limit=3"

const res = await fetch("https://apis-cloud.net/prefectures/all?limit=3");
const data = await res.json();

import urllib.request, json

with urllib.request.urlopen("https://apis-cloud.net/prefectures/all?limit=3") as r:
    data = json.load(r)

フィールド

1レコードは次の 10 個のフィールドを持つ。値の例は実際の1件目から取っている。

`code`string	01
`name`string	北海道
`kana`string	ほっかいどう
`romaji`string	Hokkaido
`capital`string	札幌市
`capitalRomaji`string	Sapporo
`region`string	北海道
`area`number	83424
`population`number	5224614
`isoCode`string	JP-01

必要な列だけ取得

curl -s "https://apis-cloud.net/prefectures/all?fields=code,name&limit=3"

const res = await fetch("https://apis-cloud.net/prefectures/all?fields=code,name&limit=3");
const data = await res.json();

import urllib.request, json

with urllib.request.urlopen("https://apis-cloud.net/prefectures/all?fields=code,name&limit=3") as r:
    data = json.load(r)

使用例

GET`/prefectures/13`

GET`/prefectures/東京都`

GET`/prefectures/Tokyo`

GET`/prefectures/random`

GET`/prefectures/all?sort=population&order=desc&limit=5`

GET`/prefectures/getCapital`

GET`/prefectures/search?q=九州`

ランダムに3件（seed 固定）

curl -s "https://apis-cloud.net/prefectures/random?count=3&seed=demo"

const res = await fetch("https://apis-cloud.net/prefectures/random?count=3&seed=demo");
const data = await res.json();

import urllib.request, json

with urllib.request.urlopen("https://apis-cloud.net/prefectures/random?count=3&seed=demo") as r:
    data = json.load(r)