Skip to main content

批量写入老师信息

1. 接口描述​

请求方式：POST

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

本接口用于在 tenantId 指定学校下创建老师

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

2. 输入参数​

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

参数名称参数类型数据类型必选描述
tenantIdurl pathint是需要拉取的租户 ID，为 url path 中的参数
teachersRequestBody(JSON)对象数组是老师信息
teachers.nameRequestBody(JSON)string是老师姓名
teachers.phoneRequestBody(JSON)string是老师手机号
teachers.rolesRequestBody(JSON)字符串数组是老师角色
teachers.subjectsRequestBody(JSON)字符串数组是老师任教科目

请求体示例:

{
    "teachers": [
        {
            "name": "老师姓名",
            "phone": "71100000001",
            "roles": ["教务老师"],
            "subjects": ["语文"]
        }
    ],
    "tenantId": 123456
}
Tips
  • 任教科目、角色根据实际情况填写

3. 返回结果​

如果单次请求老师数量超过约定限制，返回 code 为 "40004"，例如:

{"code":"40004","message":"单次写入老师数量超过上限","result":null}

如果创建的老师中，手机号前缀不满足约定，返回 code 为 "40002"，例如:

{"code":"40002","message":"手机号前缀应为 ...","result":null}

如果创建老师请求会导致该学校内老师数量超出约定数量，返回 code 为 "40003"，例如:

{"code":"40003","message":"教师数量超出限制","result":null}

如果操作成功，返回 code 为 "0"，例如:

{"code":"0","message":null,"result":null}