更新用户信息
接口说明
更新当前登录用户的个人信息
该接口需要在APP后台启用登录
请求路径
Method |
URI Path |
鉴权方式 |
POST |
/v1/user/update |
Token认证 |
请求参数
公共参数
参数名 |
类型 |
取值范围 |
是否必须 |
说明 |
Authorization |
string |
Bearer + token |
是 |
登录令牌,Header传值,格式:Bearer eyJxx... |
业务参数
参数名 |
类型 |
取值范围 |
是否必须 |
说明 |
nickname |
string |
最大32字符 |
否 |
用户昵称 |
gender |
integer |
0,1,2 |
否 |
性别:0-未知,1-男,2-女 |
birthday |
string |
YYYY-MM-DD |
否 |
生日日期 |
oaid |
string |
最大128字符 |
否 |
设备唯一标识符 |
device_id |
string |
最大128字符 |
否 |
设备ID |
password |
string |
6-32字符 |
否 |
用户密码 |
email |
string |
有效邮箱格式 |
否 |
电子邮箱 |
country |
string |
最大32字符 |
否 |
国家 |
province |
string |
最大32字符 |
否 |
省份 |
city |
string |
最大32字符 |
否 |
城市 |
enter_pass |
string |
6-8字符 |
否 |
进入密码 |
ext_data |
JSON |
最大200字符的JSON |
否 |
扩展数据 |
{warning} 不需要更新的字段禁传参数名;字段清空传值为空即可
请求示例代码
- application/x-www-form-urlencoded方式
curl --location --request POST 'https://api.zaihangyun.com/v1/user/update' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Authorization: Bearer ZaihangyunToken' \
--header 'Accept: */*' \
--header 'Host: api.zaihangyun.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'nickname=herenet' \
--data-urlencode 'gender=1' \
--data-urlencode 'birthday=1997-03-04' \
--data-urlencode 'oaid=4123123132' \
--data-urlencode 'password=123456' \
--data-urlencode 'email=zaihangyun@126.com' \
--data-urlencode 'country=' \
--data-urlencode 'province=' \
--data-urlencode 'city=' \
--data-urlencode 'enter_pass=111111' \
--data-urlencode 'ext_data={ "device_id": "7290832492f7bccf", "c_number": "huawei", "packagename": "com.ape.apefather", "d_id": "16181"}'
curl --location --request POST 'https://api.zaihangyun.com/v1/user/update' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer ZaihangyunToken' \
--header 'Accept: */*' \
--header 'Host: api.zaihangyun.com' \
--header 'Connection: keep-alive' \
--data-raw '{
"nickname": "herenet1",
"gender": "1",
"birthday": "1997-03-04",
"oaid": "4123123132",
"password": "123456",
"email": "zaihangyun@126.com",
"country": "",
"province": "",
"city": "",
"enter_pass": "111111",
"ext_data": {
"device_id": "7290832492f7bccf",
"c_number": "huawei",
"packagename": "com.ape.apefather",
"d_id": "16181"
}
}'
返回响应
{
"code": 200,
"msg": "success"
}
{
"code": "400102",
"msg": "nickname length must be less than 32 characters"
}
错误码说明
查看全局错误码
错误码 |
说明 |
400101 |
nickname必须是字符串 |
400102 |
nickname长度不能超过32个字符 |
400103 |
gender必须是整数 |
400105 |
gender必须是0,1,2中的一个 |
400106 |
birthday必须是有效的日期格式 |
400107 |
oaid必须是字符串 |
400108 |
oaid长度不能超过128个字符 |
400109 |
device_id必须是字符串 |
400110 |
device_id长度不能超过128个字符 |
400113 |
password必须是字符串 |
400114 |
password长度必须大于6个字符 |
400115 |
password长度不能超过32个字符 |
400116 |
email必须是有效的邮箱地址 |
400117 |
country必须是字符串 |
400118 |
country长度不能超过32个字符 |
400119 |
province必须是字符串 |
400120 |
province长度不能超过32个字符 |
400121 |
city必须是字符串 |
400122 |
city长度不能超过32个字符 |
400123 |
enter_pass必须是字符串 |
400124 |
enter_pass长度必须大于4个字符 |
400125 |
enter_pass长度不能超过8个字符 |
400126 |
ext_data必须是有效的JSON |
400127 |
ext_data长度不能超过200个字符 |
400199 |
用户不存在 |
400250 |
更新用户信息失败 |