Fecify-用户-更新
接口信息
- 接口地址:
{your-site-url}/api/skill/account/update
- 基础 URL:
{your-site-url} 需替换为你自己的独立站 URL 地址,如 https://your-domain.com/admin
- 请求方式:
POST
- Content-Type:
application/json
- 说明: 更新用户账号信息,支持修改用户名、昵称、密码、头像、状态和备注。
认证
请求头中需要携带 skill-access-token:
| Header |
值 |
skill-access-token |
{your-skill-access-token} (请替换为你自己的 token) |
请求参数
| 参数 |
类型 |
必填 |
说明 |
id |
Number |
是 |
用户 ID,从 Fecify-正常用户-列表 等接口获取 |
username |
String |
是 |
用户账号 |
nickname |
String |
是 |
用户昵称 |
status |
Number |
是 |
账号状态:1 激活,2 禁用 |
password |
String |
否 |
用户密码,不传则不修改密码 |
remark |
String |
否 |
备注信息 |
avatar_img |
String |
否 |
用户头像完整 URL |
请求示例
cURL
curl --location --request POST '{your-site-url}/api/skill/account/update' \
--header 'skill-access-token: {your-skill-access-token}' \
--header 'Content-Type: application/json' \
--data-raw '{
"id": 148,
"status": 1,
"username": "weqrw23erweqrqewrqwer33",
"password": "11132222",
"nickname": "fdafdsafdasfasd",
"remark": "fdasfdafsd",
"avatar_img": "https://cdn12.fecmall.com/common/0/image/2026/07/20/0ec90a208dc8a6329fd645bac5196a97.png"
}'
返回结果
code 为 200 表示调用成功;code 不为 200 表示调用失败。
成功响应
{
"code": 200,
"data": {
"id": 148,
"username": "weqrw23erweqrqewrqwer33",
"nickname": "fdafdsafdasfasd",
"avatar_img": "https://cdn12.fecmall.com/common/0/image/2026/07/20/0ec90a208dc8a6329fd645bac5196a97.png",
"type": 2,
"status": 1,
"created_at": "2026-07-25 12:25:35",
"last_login_at": "2026-07-25 12:44:23",
"remark": "fdasfdafsd"
},
"message": "success"
}
返回字段说明
| 字段 |
类型 |
说明 |
code |
Number |
状态码,200 表示成功 |
message |
String |
执行结果的文字描述 |
data |
Object |
返回数据 |
data 子字段
| 字段 |
类型 |
说明 |
id |
Number |
用户 ID |
username |
String |
用户账号 |
nickname |
String |
用户昵称 |
avatar_img |
String |
用户头像完整 URL |
type |
Number |
账户类型:1 服务商开通,2 商家端主账户,3 商家端子账户 |
status |
Number |
账号状态:1 激活,2 禁用 |
created_at |
String |
账号创建时间,格式 YYYY-MM-DD HH:mm:ss |
last_login_at |
String |
最后登录时间,格式 YYYY-MM-DD HH:mm:ss |
remark |
String |
备注信息 |
注意事项
id、username、nickname、status 为必填参数。
password 不传则不修改密码,传了则会更新密码。
- 更新前建议先通过 Fecify-用户-详细 获取当前信息,在此基础上修改。