fresns

修改用户资料

开发中

PUT

http://localhost:8080/api/v2/user/edit

avatarFid 和 avatarUrl 两者留空表示不修改，传参时二选一。

bannerFid 和 bannerUrl 两者留空表示不修改，传参时二选一。

头像和背景条幅图如果使用 fid，先使用文件上传接口，上传后获得 fid 传参。

上传参数例子：

tableName = users

tableColumn = avatar_file_id 或 banner_file_id

tableKey = 当前用户的 uid 或 username

扩展资料示例：

[
    {
        "code": "code",
        "value": "value",
        "isPrivate": false, // 是否私有（是否对外公开展示）
        "pluginUnikey": null
    },
    {
        "code": "code",
        "value": "value",
        "isPrivate": true, // 是私有（0/1 或者布尔型）
        "pluginUnikey": "可空"
    }
]

请求参数

Header 参数

X-Fresns-App-Id

string

必需

密钥 App ID
密钥位置：控制面板->应用中心->应用密钥

默认值:

X-Fresns-Client-Platform-Id

integer

必需

平台编号，与密钥的「平台」匹配

默认值:

X-Fresns-Client-Version

string

必需

你的客户端版本号，推荐使用语义化版本号

默认值:

X-Fresns-Client-Device-Info

string

必需

交互设备信息 session_logs > device_info
压缩 Object 信息为字符串传参

默认值:

X-Fresns-Aid

string

可选

账号参数（留空则视为未登录账号）

默认值:

X-Fresns-Aid-Token

string

可选

账号身份凭证（传参 aid 时必传）

默认值:

X-Fresns-Uid

integer

可选

用户参数（留空则视为未登录用户）

默认值:

X-Fresns-Uid-Token

string

可选

用户身份凭证（传参 uid 时必传）

默认值:

X-Fresns-Signature

string

签名

必需

X-Fresns-Signature-Timestamp

string

必需

签名生成时间（当前 Unix 时间戳，精确到秒或毫秒都支持）

Body 参数application/json

username

string

可选

用户名（留空代表不修改）

nickname

string

可选

用户昵称（留空代表不修改）

avatarFid

string

可选

头像图文件 FID（留空代表不修改）

avatarUrl

string

可选

头像图地址（留空代表不修改）

bannerFid

string

可选

背景条幅图文件 FID（留空代表不修改）

bannerUrl

string

可选

背景条幅图地址（留空代表不修改）

gender

string

可选

性别（留空代表不修改）

birthday

string

可选

生日（留空代表不修改，格式为 Y-m-d H:i:s）

bio

string

可选

简介（留空代表不修改）

location

string

可选

位置（留空代表不修改）

conversationLimit

string

可选

对话设置（留空代表不修改）

commentLimit

string

可选

评论设置（留空代表不修改）

timezone

string

可选

偏好时区（留空代表不修改）

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'http://localhost:8080/api/v2/user/edit' \
--header 'X-Fresns-App-Id;' \
--header 'X-Fresns-Client-Platform-Id;' \
--header 'X-Fresns-Client-Version;' \
--header 'X-Fresns-Client-Device-Info;' \
--header 'X-Fresns-Aid: ' \
--header 'X-Fresns-Aid-Token: ' \
--header 'X-Fresns-Uid: ' \
--header 'X-Fresns-Uid-Token: ' \
--header 'X-Fresns-Signature;' \
--header 'X-Fresns-Signature-Timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "string",
    "nickname": "string",
    "avatarFid": "string",
    "avatarUrl": "string",
    "bannerFid": "string",
    "bannerUrl": "string",
    "gender": "string",
    "birthday": "string",
    "bio": "string",
    "location": "string",
    "conversationLimit": "string",
    "commentLimit": "string",
    "timezone": "string",
    "archives": "string",
    "deviceToken": "string"
}'

返回响应

🟢200成功

application/json

Body

code

integer

必需

message

string

必需

data

null

必需

示例

{
    "code": 0,
    "message": "ok",
    "data": null
}

用户面板

操作标记