成语接龙
最后更新于：2022-04-02 08:22:02
## 成语接龙
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 成语接龙接口，默认为用户开局。返回字段中包含成语拼音、解释、来源、首尾字符、积分、胜负结果和友好提示。其中字段result为胜负结果，0为开局、1为胜、2-4都是负（2开局负，3接错了，4非成语）、5为赢局（2-5都会退出游戏）
>[danger] 请注意：userid参数应该是一个唯一识别码，例如用户的IMEI或openid等等。否则会把你的所有用户都当成一个人，导致数据混乱。
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/chengyu/jielong
```
### 请求参数
| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| word | string | 是 | 成语 |
| userid | string | 是 | 用户唯一识别码 |
| statetime | int | 否 | 状态维持时间，单位秒，默认1800 |
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| chengyu | string | 一马当先 | 成语 |
| pinyin | string | yī mǎ dāng xiān | 成语拼音 |
| jieshi | string | 原指作战时策马冲锋在前。形容领先。也比喻工作走在群众前面，积极带头。 | 成语解释 |
| chuchu | string | 明·施耐庵《水浒传》第九十六回：即便勒兵列阵，一马当先...... | 成语出处 |
| startstr | string | 一 | 成语开头汉字 |
| endstr | string | 先 | 成语末尾汉字 |
| grade | int | 0 | 游戏积分 |
| result | int | 0 | 胜负结果，0为开局、1为胜、2-4都是负、5为赢局（2-5都会退出游戏） |
| tip | string | 恭喜你答对了，系统奖励了你1分...... | 游戏提示 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->chengyuJielong()
->withWord('先见之明')
->withUserid('98105401289c18d858c169578ecf0125')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功",
"data": [
{
"chengyu":"先见之明",
"pinyin":"xiān jiàn zhī míng",
"jieshi":"明·指眼力。事先看清问题的能力。指对事物发展的预见性。",
"chuchu":"《后汉书·杨彪传》：愧无日磾先见之明，犹怀老牛舐犊之爱。",
"startstr":"先",
"endstr":"明",
"grade":0,
"result":0,
"tip":"已进入成语接龙模式：先见之明"
}
]
}
~~~
';