Skip to main content

批量获取老师信息

1. 接口描述

请求方式:POST

接口请求地址:mapi.feixiangxingqiu.com/metis-atlas-account/api/open/tenant/{tenantId}/teachers。

本接口用于拉取特定 tenantId 下的所有老师

  • 只有第三方具备获取该租户的权限时才可成功

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 OpenApi 指引

参数名称参数类型数据类型必选描述
tenantIdurl pathint需要拉取的租户 ID,为 url path 中的参数
cursorRequestBody(JSON)String用于分页查询的游标,字符串类型,由上一次调用返回,首次调用可不填
limitRequestBody(JSON)int返回的最大记录数,整型,取值范围 1-100,默认为 20

请求体示例:

{
"cursor":"DwHU25ISMIeu1/uRhPFTDw==",
"limit":50
}
Tips
  • 首次调用接口时,cursor 参数无需填写
  • 下次调用的 cursor 参数,使用上一次调用返回结果中的 nextCursor
  • 上一次调用结果返回的 nextCursor 存在有效期限制,请勿缓存使用

3. 返回结果

返回该租户下的所有老师信息的列表。 老师信息数据结构参见 获取教师详情信息/返回结果

字段名类型描述
nextCursorString分页游标,再下次请求时填写以获取之后分页的记录,如果已经没有更多的数据则返回空,有效期为1小时
list.accountIdint查询的用户 ID
list.phonestring用户手机号
list.namestring用户名字

例如

{
"nextCursor": "DwHU25ISMIeu1/uRhPFTDw==",
"list": [
{"accountId": 1, "phone": "18800000000", "name": "老师A"},
{"accountId": 2, "phone": "16600000000", "name": "老师B"}
]
}