更新用户

正式环境

POST

https://www.plaso.cn/dataentry/user/update

最后修改时间：2024-12-17 06:39:38

请求参数

Body 参数application/json

userId

string

伯索侧分配的用户ID

必需

userName

string

用户姓名

可选

string

邮箱地址

可选

grade

number

年级

可选

教师没有年级

sex

number

性别

可选

school

string

所在学校信息

可选

note

string

备注信息

可选

activeUntilTimestamp

number

学生账号过期时间

可选

格式为13位时间戳；以北京时区为准，不可早于北京时间当天。

studentCustomFields

string

学生的自定义字段信息

可选

当编辑学生时，根据机构设置的可进行"编辑"操作的学生自定义字段“管理选项”（必填、选填、关闭）进行校验。对象数组字符串，如"[{"key": "s0","value": "写作"},{"key": "s1","value": "阅读"}]"，

示例

{
  "userId": "1_30385972",
  "grade": 40,
  "email": "x.tnmzebe@zdqmkqn.kp",
  "school": "伯索大学",
  "sex": 1,
  "note": "dolore aliquip mollit quis ut",
  "userName": "汪秀英",
  "activeUntilTimestamp": 4865327999000,
  "studentCustomFields": "[{\"key\": \"s0\",\"value\": \"写作\"},{\"key\": \"s1\",\"value\": \"阅读\"}]"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://www.plaso.cn/dataentry/user/update' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "1_30385972",
    "grade": 40,
    "email": "x.tnmzebe@zdqmkqn.kp",
    "school": "伯索大学",
    "sex": 1,
    "note": "dolore aliquip mollit quis ut",
    "userName": "汪秀英",
    "activeUntilTimestamp": 4865327999000,
    "studentCustomFields":"[{\"key\": \"s0\",\"value\": \"写作\"},{\"key\": \"s1\",\"value\": \"阅读\"}]"
}'

返回响应

🟢200请求成功

application/json

Body

msg

string

必需

code

integer

必需

obj

object

必需

msg

string

响应信息

必需

reqId

string

必需

reqTime

integer

必需

execTime

integer

必需

示例

成功示例未传用户id

{
  "msg": "remote call success",
  "code": 0,
  "obj": {
    "msg": "更新成功"
  },
  "reqId": "1699603754379_0.9976632151310059",
  "reqTime": 1699603754379,
  "execTime": 12599
}

修改于 2024-12-17 06:39:38

删除用户

用户精确查询