成语典故
最后更新于：2022-04-02 08:22:04
## 成语典故
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 包括成语典故、来源、范例、拼音等，支持模糊搜索。
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/chengyu/allusion
```
### 请求参数
| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| word | string | 是 | 搜索词 |
| num | int | 否 | 返回数量 1-50 |
| mode| int | 否 | 0严格搜索、1模糊搜索、2拼音简写搜索|
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| chengyu | string | 马到成功 | 成语 |
| pinyin | string | mǎ dào chéng gōng | 拼音音标 |
| diangu | string | 形容工作刚开始就取得成功。 | 典故 |
| chuchu | string | 元·无名氏《小尉迟》第二折：“那老尉迟这一去，马到成功。” | 出处 |
| fanli | string | 只要不轻敌，相信你们一定会～。 | 范例 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->chengyuAllusion()
->withWord('马到成功')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功",
"data": [
{
"chengyu":"马到成功",
"pinyin":"mǎ dào chéng gōng",
"diangu":"形容工作刚开始就取得成功。",
"chuchu":"元·无名氏《小尉迟》第二折：“那老尉迟这一去，马到成功。”",
"fanli":"只要不轻敌，相信你们一定会～。",
"pysx": "mdcg"
}
]
}
~~~
';