二十四節気API
立春から大寒までの二十四節気。日付は太陽黄経で決まるため年によって1日前後する（approxDate は目安）。
| エンドポイント | https://apis-cloud.net/sekki |
| 件数 | 24 件 |
| 形式 | JSON（UTF-8） |
| 認証 | 不要（CORS 全オリジン許可） |
| ID フィールド | name（order kana romaji でも引ける） |
| 検索対象 | name kana romaji season meaning |
リクエスト
curl -s "https://apis-cloud.net/sekki/1"const res = await fetch("https://apis-cloud.net/sekki/1");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/sekki/1") as r:
data = json.load(r)
レスポンス
200 OK
{
"order": 1,
"name": "立春",
"kana": "りっしゅん",
"romaji": "Risshun",
"season": "春",
"approxDate": "2月4日頃",
"meaning": "暦の上で春が始まる日。1年の起点とされ、八十八夜や二百十日はここから数える。"
}エンドポイント
二十四節気APIは、他のリソースと同じ共通の形をしている。 パラメータの詳しい説明は 共通エンドポイントの節 にある。
GET/sekki |
メタ情報（件数・フィールド・エンドポイント） | |
GET/sekki/all |
全24件 | |
GET/sekki/random |
ランダムに1件 | |
GET/sekki/search?q=立春 |
部分一致検索 | |
GET/sekki/fields |
フィールド名の一覧 | |
GET/sekki/getName |
name の列だけ取り出す | |
GET/sekki/1 |
ID 指定で1件 | |
GET/sekki/1/name |
1件の特定フィールド | |
全件取得
curl -s "https://apis-cloud.net/sekki/all?limit=3"const res = await fetch("https://apis-cloud.net/sekki/all?limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/sekki/all?limit=3") as r:
data = json.load(r)フィールド
1レコードは次の 7 個のフィールドを持つ。値の例は実際の1件目から取っている。
ordernumber | 1 |
namestring | 立春 |
kanastring | りっしゅん |
romajistring | Risshun |
seasonstring | 春 |
approxDatestring | 2月4日頃 |
meaningstring | 暦の上で春が始まる日。1年の起点とされ、八十八夜や二百十日はここから数える。 |
必要な列だけ取得
curl -s "https://apis-cloud.net/sekki/all?fields=order,name&limit=3"const res = await fetch("https://apis-cloud.net/sekki/all?fields=order,name&limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/sekki/all?fields=order,name&limit=3") as r:
data = json.load(r)使用例
GET/sekki/立春 |
||
GET/sekki/10 |
||
GET/sekki/random |
||
GET/sekki/all?fields=name,approxDate |
||
GET/sekki/search?q=夏 |
||
ランダムに3件（seed 固定）
curl -s "https://apis-cloud.net/sekki/random?count=3&seed=demo"const res = await fetch("https://apis-cloud.net/sekki/random?count=3&seed=demo");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/sekki/random?count=3&seed=demo") as r:
data = json.load(r)二十四節気APIのよくある質問
- 二十四節気の一覧はどう取得しますか？
- GET https://apis-cloud.net/sekki/all で全24件がJSONで返ります。1件だけ欲しいときは /sekki/random、ID を指定するときは /sekki/{name} を使います。
- 二十四節気APIに認証は必要ですか？
- 不要です。API キーもトークンもなく、GET するだけで使えます。CORS も全オリジンに開けているのでブラウザから直接呼べます。
- 二十四節気APIにはどんなフィールドがありますか？
- order、name、kana、romaji、season、approxDate、meaning の 7 個です。?fields= で必要な列だけに絞れます。検索は name、kana、romaji、season、meaning が対象です。