ことわざ・故事成語API
日本のことわざと、漢籍などに由来する故事成語。type でどちらかを区別できる。四字熟語は /yojijukugo にある。
| エンドポイント | https://apis-cloud.net/kotowaza |
| 件数 | 54 件 |
| 形式 | JSON（UTF-8） |
| 認証 | 不要（CORS 全オリジン許可） |
| ID フィールド | text（kana でも引ける） |
| 検索対象 | text kana meaning type source |
リクエスト
# /kotowaza/圧巻
curl -s "https://apis-cloud.net/kotowaza/%E5%9C%A7%E5%B7%BB"// /kotowaza/圧巻
const res = await fetch("https://apis-cloud.net/kotowaza/%E5%9C%A7%E5%B7%BB");
const data = await res.json();# /kotowaza/圧巻
import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/kotowaza/%E5%9C%A7%E5%B7%BB") as r:
data = json.load(r)
レスポンス
200 OK
{
"text": "圧巻",
"kana": "あっかん",
"meaning": "全体の中で最も優れた部分。科挙で最優秀の答案を一番上に載せた故事から。",
"type": "故事成語",
"source": "科挙の故事"
}エンドポイント
ことわざ・故事成語APIは、他のリソースと同じ共通の形をしている。 パラメータの詳しい説明は 共通エンドポイントの節 にある。
GET/kotowaza |
メタ情報（件数・フィールド・エンドポイント） | |
GET/kotowaza/all |
全54件 | |
GET/kotowaza/random |
ランダムに1件 | |
GET/kotowaza/search?q=圧巻 |
部分一致検索 | |
GET/kotowaza/fields |
フィールド名の一覧 | |
GET/kotowaza/getText |
text の列だけ取り出す | |
GET/kotowaza/圧巻 |
ID 指定で1件 | |
GET/kotowaza/圧巻/kana |
1件の特定フィールド | |
全件取得
curl -s "https://apis-cloud.net/kotowaza/all?limit=3"const res = await fetch("https://apis-cloud.net/kotowaza/all?limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/kotowaza/all?limit=3") as r:
data = json.load(r)フィールド
1レコードは次の 5 個のフィールドを持つ。値の例は実際の1件目から取っている。
textstring | 圧巻 |
kanastring | あっかん |
meaningstring | 全体の中で最も優れた部分。科挙で最優秀の答案を一番上に載せた故事から。 |
typestring | 故事成語 |
sourcestring | 科挙の故事 |
必要な列だけ取得
curl -s "https://apis-cloud.net/kotowaza/all?fields=text,kana&limit=3"const res = await fetch("https://apis-cloud.net/kotowaza/all?fields=text,kana&limit=3");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/kotowaza/all?fields=text,kana&limit=3") as r:
data = json.load(r)使用例
GET/kotowaza/急がば回れ |
||
GET/kotowaza/random |
||
GET/kotowaza/search?q=故事成語 |
||
GET/kotowaza/all?fields=text,meaning |
||
GET/kotowaza/getType?unique=1 |
||
ランダムに3件（seed 固定）
curl -s "https://apis-cloud.net/kotowaza/random?count=3&seed=demo"const res = await fetch("https://apis-cloud.net/kotowaza/random?count=3&seed=demo");
const data = await res.json();import urllib.request, json
with urllib.request.urlopen("https://apis-cloud.net/kotowaza/random?count=3&seed=demo") as r:
data = json.load(r)ことわざ・故事成語APIのよくある質問
- ことわざ・故事成語の一覧はどう取得しますか？
- GET https://apis-cloud.net/kotowaza/all で全54件がJSONで返ります。1件だけ欲しいときは /kotowaza/random、ID を指定するときは /kotowaza/{text} を使います。
- ことわざ・故事成語APIに認証は必要ですか？
- 不要です。API キーもトークンもなく、GET するだけで使えます。CORS も全オリジンに開けているのでブラウザから直接呼べます。
- ことわざ・故事成語APIにはどんなフィールドがありますか？
- text、kana、meaning、type、source の 5 個です。?fields= で必要な列だけに絞れます。検索は text、kana、meaning、type、source が対象です。