批量获取老师信息
1. 接口描述
请求方式:POST
接口请求地址:mapi.feixiangxingqiu.com/metis-atlas-account/api/open/tenant/{tenantId}/teachers。
本接口用于拉取特定 tenantId 下的所有老师
- 只有第三方具备获取该租户的权限时才可成功
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 OpenApi 指引
参数名称 | 参数类型 | 数据类型 | 必选 | 描述 |
---|---|---|---|---|
tenantId | url path | int | 是 | 需要拉取的租户 ID,为 url path 中的参数 |
cursor | RequestBody(JSON) | String | 否 | 用于分页查询的游标,字符串类型,由上一次调用返回,首次调用可不填 |
limit | RequestBody(JSON) | int | 否 | 返回的最大记录数,整型,取值范围 1-100,默认为 20 |
请求体示例:
{
"cursor":"DwHU25ISMIeu1/uRhPFTDw==",
"limit":50
}
Tips
- 首次调用接口时,
cursor
参数无需填写 - 下次调用的
cursor
参数,使用上一次调用返回结果中的nextCursor
- 上一次调用结果返回的
nextCursor
存在有效期限制,请勿缓存使用
3. 返回结果
返回该租户下的所有老师信息的列表。 老师信息数据结构参见 获取教师详情信息/返回结果
字段名 | 类型 | 描述 |
---|---|---|
nextCursor | String | 分页游标,再下次请求时填写以获取之后分页的记录,如果已经没有更多的数据则返回空,有效期为1小时 |
list.accountId | int | 查询的用户 ID |
list.phone | string | 用户手机号 |
list.name | string | 用户名字 |
例如
{
"nextCursor": "DwHU25ISMIeu1/uRhPFTDw==",
"list": [
{"accountId": 1, "phone": "18800000000", "name": "老师A"},
{"accountId": 2, "phone": "16600000000", "name": "老师B"}
]
}