获取包含年级下的书本列表。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
aicontent:ListTextbookAssistantBooks |
list |
*全部资源
|
无 | 无 |
请求语法
POST /api/v1/textbookAssistant/teachingResource/ListBooks HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| body |
object |
否 |
请求体对象。 |
|
| bookId |
string |
否 |
书本编号 ID |
231698 |
| grade |
string |
否 |
年级，取值范围 1-9，和年级 level 对应 |
1 |
| volume |
string |
否 |
册次，0：全一册，1：上册，2：下册 |
1 |
| version |
string |
否 |
教材版本 |
人教版 |
| page |
string |
否 |
页码 |
1 |
| maxResults |
string |
否 |
每页最大条目数，最大值 20。 |
20 |
| authToken |
string |
是 |
接口调用授权码,可以通过获取"英语教材式 AI 老师功能使用授权码"接口获取。 |
tc_197bf5bb81889cc79eb51ae9b8c0cea3 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| requestId |
string |
Id of the request |
B695B377-7029-5805-9DE2-1AAE06C1BF6B |
| success |
boolean |
是否成功 |
true |
| errCode |
string |
错误码 |
B_USER_NOT_FOUND_EXCEPTION |
| errMessage |
string |
错误信息 |
用户不存在 |
| httpStatusCode |
integer |
HTTP 状态码 |
200 |
| data |
object |
返回数据对象。 |
|
| paginationData |
object |
分页数据 |
|
| totalCount |
integer |
全量数据的条数 |
200 |
| maxResults |
integer |
本次查询单页的数据条数 |
20 |
| currentPage |
integer |
当前页码。 |
1 |
| bookList |
array<object> |
书本列表信息 |
|
|
object |
|||
| bookId |
string |
书本编号 Id |
231698 |
| isbn |
string |
国际标准书号 |
9787107382505 |
| edition |
string |
版次 |
2024-7（1） |
| impression |
string |
印次 |
2024-7（1） |
| publisher |
string |
出版社 |
人民教育出版社 |
| version |
string |
教材版本 |
人教版 |
| subject |
string |
学科 |
ENGLISH |
| grade |
string |
年级，取值范围 1-9，对应年级 level |
3 |
| volume |
string |
册次，0：全一册，1：上册，2：下册 |
0 |
| author |
string |
作者信息 |
吴欣 |
| bookName |
string |
书本名称 |
K12英语-人教版PEP三起-三年级上册 |
| coverImage |
string |
书本封面 |
null |
示例
正常返回示例
JSON格式
{
"requestId": "B695B377-7029-5805-9DE2-1AAE06C1BF6B",
"success": true,
"errCode": "B_USER_NOT_FOUND_EXCEPTION",
"errMessage": "用户不存在",
"httpStatusCode": 200,
"data": {
"paginationData": {
"totalCount": 200,
"maxResults": 20,
"currentPage": 1
},
"bookList": [
{
"bookId": "231698",
"isbn": "9787107382505",
"edition": "2024-7（1）",
"impression": "2024-7（1）",
"publisher": "人民教育出版社",
"version": "人教版",
"subject": "ENGLISH",
"grade": "3",
"volume": "0",
"author": "吴欣",
"bookName": "K12英语-人教版PEP三起-三年级上册",
"coverImage": "null"
}
]
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。