上传勋章图片

POST

/admin/v1/badge_images

通过该接口可以上传勋章详情图、挂饰图的文件，获取对应的文件key。

HTTP状态码	错误码	描述	排查建议
500	1051000	unknown server error	服务内部错误，请稍后重试
400	1051001	request contain invalid param	请求中包含非法参数
403	1051002	request to exceed authority	请求发生越权
400	1051100	the image size is too large	上传的图片大小不符合要求
400	1051101	the image format is illegal	上传的图片格式不符合要求
400	1051109	the image height is too small	图片尺寸高度过小
400	1051110	the image height is too large	图片尺寸高度过大
400	1051111	the aspect ratio of the image is too small	图片尺寸宽高比过小
400	1051112	the aspect ratio of the image is too large	图片尺寸宽高比过大

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

🟢200成功

application/json

Body

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/admin/v1/badge_images' \
--header 'Authorization: Bearer <token>' \
--form 'image_file=""' \
--form 'image_type=""'

响应示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "image_key": "f02a98aa-1413-4af6-93ab-431ba9e5f2cg"
    }
}

修改于 2025-10-21 08:20:10