元曲三百首
最后更新于：2022-04-02 08:21:55
## 元曲三百首
>[danger]### 会员接口，仅限会员使用，购买[API会员](https://market.topthink.com/product/210)
> 元曲三百首接口，返回词曲类型、作者、批注、翻译等。
## 接口调用（[调用须知](https://docs.topthink.com/think-api/1835086)）
### 请求地址
```
GET https://api.topthink.com/literary/yuan
```
### 请求参数
| 名称 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| appCode| string|是|用户授权码，参考[API调用](https://docs.topthink.com/think-api/1835086) |
| word | string | 是 | 搜索词，曲名或作者 |
| num | int | 否 | 返回数量，取值1-10 |
| page | int | 否 | 翻页 |
### 返回`data`参数
| 名称 | 类型 | 示例值 | 说明 |
| --- | --- | --- | --- |
| chapter | string | 散曲 | 词曲类型 |
| title | string | 折桂令 | 曲名 |
| content | string | 草茫茫秦汉陵阙，世代兴亡，却便似月影圆缺...... | 内容 |
| note | string | 拟：模拟。张鸣善；元代后期散曲作家...... | 批注 |
| author | string | 倪 瓒 | 作者 |
| translation | string | 秦汉皇陵一片茫茫野草，世世代代兴亡更替...... | 译文 |
## SDK调用
```
$client = new Client("YourAppCode");
$result = $client->literaryYuan()
->withWord('折桂令')
->request();
```
返回示例：
~~~
{
"code":0,
"message": "成功",
"data": [
{
"chapter":"散曲",
"title":"折桂令",
"content":"草茫茫秦汉陵阙，世代兴亡，却便似月影圆缺。山人室堆案图书，当窗松桂，满地薇蕨。侯门深何须刺谒，白云自可怡悦。到如今世事难说，天地间不见一个英雄，不见一个豪杰。",
"note":"拟：模拟。张鸣善；元代后期散曲作家。从内容看，可能是模仿张鸣善《水仙子·讥时》。陵阙：指帝王的坟墓。山人家：山居的人，作者自称。堆案图书：形容藏书丰富。案，桌子。薇蕨：皆草本植物。伯夷、齐叔不食周粟，隐居首阳山、采薇而食。后世以“薇蕨”为隐者之粮。侯门。泛指官宦显贵人家。刺谒：求见、拜访。刺，类似后来的名片。",
"author":"倪 瓒",
"translation":"秦汉皇陵一片茫茫野草，世世代代兴亡更替，就像那月影有圆有缺。山人的家里图书堆满案桌，当窗可见松桂姿影，满地都是野生薇蕨。侯门深如海何须去拜见，空中的白云尽可欣赏怡悦。到如今纷繁世事难以言说。茫茫天地之间见不到一个英雄，见不到一个豪杰。"
}
]
}
~~~
';