dddd

  1. 更新用户信息
    允许已授权的用户通过此接口更新自己的信息
    ● URL:/api/user
    ● Method:PUT
    ● 需要登录:
    ● 需要鉴权:

2. 请求参数
参数
类型
约束
first_name
String
1到30个字符
last_name
String
1到30个字符
注意:id 和 email 字段目前是只读属性,不允许通过此接口进行修改。
 
3. 请求示例
可以仅传递部分请求参数
{
"first_name": "John"
}

4. 成功响应
条件:请求参数合法,并且用户身份校验通过。
状态码:200 OK
响应示例:响应会将修改后的用户信息数据返回,一个id为1234的用户设置他们的姓名后将会返回:
{
"id": 1234,
"first_name": "Joe",
"last_name": "Bloggs",
"email": "joe25@example.com"
}

5. 错误响应
条件:请求数据非法,例如fist_name的长度过长。
状态码:400 BAD REQUEST
响应示例:
{
"first_name": "Please provide maximum 30 character or empty string"
}

6. 注意事项
如果用户的用户信息不存在,将会使用请求的数据创建一个新的用户信息。

posted @ 2025-01-06 18:15  一声尖叫  阅读(23)  评论(0)    收藏  举报