上传 Flutter 背景图片

PUT

/profile/flutter/image/upload

上传 Flutter 主题的背景图片

✅ 功能特性：

支持 JPEG 和 PNG 格式

限制文件大小为 5MB 以内

上传后返回临时 UUID，需要通过 /update 接口确认才会保存

⚠️ 限制条件：

仅支持 JPEG 和 PNG 格式

文件大小不能超过 5MB

上传的临时文件有效期为 1 小时

💡 使用场景：

用户上传深色模式背景图片

用户上传浅色模式背景图片

Args:
background_image_upload: 背景图片文件

Returns:
FlutterImageUploadResponse: 包含临时图片 UUID

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.loveac.linota.cn/profile/flutter/image/upload' \
--header 'Authorization: Bearer <token>' \
--form 'background_image_upload=@""'

返回响应

🟢200成功

application/json

Successful Response

Body

示例

{
    "success": true,
    "message": "string",
    "data": {
        "uuid": "string",
        "md5": "string"
    },
    "error": {
        "message": "string",
        "code": "string",
        "trace_id": "string"
    },
    "timestamp": "string"
}

🟠400请求有误

🟠401未认证

🟠404未找到

🟠410已删除

🟠413请求体过大

🟠415不支持的媒体类型

🟠422无法处理的实体

🔴500服务器内部错误

🔴502网关错误

修改于 2025-11-05 11:01:53

获取 Flutter 用户资料

更新 Flutter 用户资料