元号API
大化（645年）から令和までの全元号。南北朝時代は court に「南朝」「北朝」を入れている（両朝で用いられた建武は南朝側の1件のみ収録）。改元年は前後の元号で重複する。継続中の元号は endYear と years が null で ongoing が true。
| エンドポイント | https://apis-cloud.net/eras |
| 件数 | 248 件 |
| 形式 | JSON（UTF-8） |
| 認証 | 不要（CORS 全オリジン許可） |
| ID フィールド | name（kana romaji でも引ける） |
| 検索対象 | name kana romaji period court |
リクエスト
curl -s "https://apis-cloud.net/eras/Taika"const res = await fetch("https://apis-cloud.net/eras/Taika");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/eras/Taika") as r:
data = json.load(r)
レスポンス
200 OK
{
"name": "大化",
"kana": "たいか",
"romaji": "Taika",
"startYear": 645,
"endYear": 650,
"period": "飛鳥",
"court": null,
"ongoing": false,
"years": 5
}エンドポイント
元号APIは、他のリソースと同じ共通の形をしている。 パラメータの詳しい説明は 共通エンドポイントの節 にある。
GET/eras |
メタ情報（件数・フィールド・エンドポイント） | |
GET/eras/all |
全248件 | |
GET/eras/random |
ランダムに1件 | |
GET/eras/search?q=大化 |
部分一致検索 | |
GET/eras/fields |
フィールド名の一覧 | |
GET/eras/getName |
name の列だけ取り出す | |
GET/eras/Taika |
ID 指定で1件 | |
GET/eras/Taika/kana |
1件の特定フィールド | |
GET/eras/year/{year} |
西暦からその年の元号を引く（改元年は複数返る） | |
全件取得
curl -s "https://apis-cloud.net/eras/all?limit=3"const res = await fetch("https://apis-cloud.net/eras/all?limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/eras/all?limit=3") as r:
data = json.load(r)フィールド
1レコードは次の 9 個のフィールドを持つ。値の例は実際の1件目から取っている。
namestring | 大化 |
kanastring | たいか |
romajistring | Taika |
startYearnumber | 645 |
endYearnumber | 650 |
periodstring | 飛鳥 |
courtnullable | — |
ongoingboolean | false |
yearsnumber | 5 |
必要な列だけ取得
curl -s "https://apis-cloud.net/eras/all?fields=name,kana&limit=3"const res = await fetch("https://apis-cloud.net/eras/all?fields=name,kana&limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/eras/all?fields=name,kana&limit=3") as r:
data = json.load(r)使用例
GET/eras/令和 |
||
GET/eras/Genroku |
||
GET/eras/year/1600 |
||
GET/eras/random |
||
GET/eras/search?q=江戸 |
||
GET/eras/all?fields=name,startYear&limit=10 |
||
ランダムに3件（seed 固定）
curl -s "https://apis-cloud.net/eras/random?count=3&seed=demo"const res = await fetch("https://apis-cloud.net/eras/random?count=3&seed=demo");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/eras/random?count=3&seed=demo") as r:
data = json.load(r)元号APIのよくある質問
- 元号の一覧はどう取得しますか？
- GET https://apis-cloud.net/eras/all で全248件がJSONで返ります。1件だけ欲しいときは /eras/random、ID を指定するときは /eras/{name} を使います。
- 元号APIに認証は必要ですか？
- 不要です。API キーもトークンもなく、GET するだけで使えます。CORS も全オリジンに開けているのでブラウザから直接呼べます。
- 元号APIにはどんなフィールドがありますか？
- name、kana、romaji、startYear、endYear、period、court、ongoing、years の 9 個です。?fields= で必要な列だけに絞れます。検索は name、kana、romaji、period、court が対象です。