四字熟語API
漢字四文字の熟語。出典が漢籍にあるものは source に典拠を記している。二字・五字の故事成語は /kotowaza にある。
| エンドポイント | https://apis-cloud.net/yojijukugo |
| 件数 | 48 件 |
| 形式 | JSON（UTF-8） |
| 認証 | 不要（CORS 全オリジン許可） |
| ID フィールド | word（kana でも引ける） |
| 検索対象 | word kana meaning source |
リクエスト
# /yojijukugo/一意専心
curl -s "https://apis-cloud.net/yojijukugo/%E4%B8%80%E6%84%8F%E5%B0%82%E5%BF%83"// /yojijukugo/一意専心
const res = await fetch("https://apis-cloud.net/yojijukugo/%E4%B8%80%E6%84%8F%E5%B0%82%E5%BF%83");
const data = await res.json();# /yojijukugo/一意専心
import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/yojijukugo/%E4%B8%80%E6%84%8F%E5%B0%82%E5%BF%83") as r:
data = json.load(r)
レスポンス
200 OK
{
"word": "一意専心",
"kana": "いちいせんしん",
"meaning": "他に心を移さず、ひとつのことに集中すること。",
"source": "管子 内業"
}エンドポイント
四字熟語APIは、他のリソースと同じ共通の形をしている。 パラメータの詳しい説明は 共通エンドポイントの節 にある。
GET/yojijukugo |
メタ情報（件数・フィールド・エンドポイント） | |
GET/yojijukugo/all |
全48件 | |
GET/yojijukugo/random |
ランダムに1件 | |
GET/yojijukugo/search?q=一意 |
部分一致検索 | |
GET/yojijukugo/fields |
フィールド名の一覧 | |
GET/yojijukugo/getWord |
word の列だけ取り出す | |
GET/yojijukugo/一意専心 |
ID 指定で1件 | |
GET/yojijukugo/一意専心/kana |
1件の特定フィールド | |
全件取得
curl -s "https://apis-cloud.net/yojijukugo/all?limit=3"const res = await fetch("https://apis-cloud.net/yojijukugo/all?limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/yojijukugo/all?limit=3") as r:
data = json.load(r)フィールド
1レコードは次の 4 個のフィールドを持つ。値の例は実際の1件目から取っている。
wordstring | 一意専心 |
kanastring | いちいせんしん |
meaningstring | 他に心を移さず、ひとつのことに集中すること。 |
sourcestring | 管子 内業 |
必要な列だけ取得
curl -s "https://apis-cloud.net/yojijukugo/all?fields=word,kana&limit=3"const res = await fetch("https://apis-cloud.net/yojijukugo/all?fields=word,kana&limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/yojijukugo/all?fields=word,kana&limit=3") as r:
data = json.load(r)使用例
GET/yojijukugo/一期一会 |
||
GET/yojijukugo/random |
||
GET/yojijukugo/search?q=論語 |
||
GET/yojijukugo/all?fields=word,kana |
||
GET/yojijukugo/getWord |
||
ランダムに3件（seed 固定）
curl -s "https://apis-cloud.net/yojijukugo/random?count=3&seed=demo"const res = await fetch("https://apis-cloud.net/yojijukugo/random?count=3&seed=demo");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/yojijukugo/random?count=3&seed=demo") as r:
data = json.load(r)四字熟語APIのよくある質問
- 四字熟語の一覧はどう取得しますか？
- GET https://apis-cloud.net/yojijukugo/all で全48件がJSONで返ります。1件だけ欲しいときは /yojijukugo/random、ID を指定するときは /yojijukugo/{word} を使います。
- 四字熟語APIに認証は必要ですか？
- 不要です。API キーもトークンもなく、GET するだけで使えます。CORS も全オリジンに開けているのでブラウザから直接呼べます。
- 四字熟語APIにはどんなフィールドがありますか？
- word、kana、meaning、source の 4 個です。?fields= で必要な列だけに絞れます。検索は word、kana、meaning、source が対象です。