上传勋章图片

POST

https://open.feishu.cn/open-apis/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	图片尺寸宽高比过大

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://open.feishu.cn/open-apis/admin/v1/badge_images' \
--header 'Authorization;' \
--form 'image_file=""' \
--form 'image_type=""'

响应示例

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

请求参数

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数multipart/form-data

image_file

string

必需

勋章图片的文件，仅支持 PNG 格式，320 x 320 像素，大小不超过 1024 KB。

示例值：file binary

image_type

integer

必需

图片的类型

示例值：1

可选值有：

1：勋章详情图
2：勋章挂饰图
数据校验规则：

取值范围：1 ～ 2

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

image_key

string

图片的key

必需

修改于 2023-02-03 09:54:43

修改勋章信息

获取勋章列表

上传勋章图片

错误码#

请求参数

返回响应

错误码