获取勋章列表

可以通过该接口列出租户下所有的勋章，勋章的排列顺序是按照创建时间倒序排列。

错误码

HTTP状态码	错误码	描述	排查建议
500	1051000	unknown server error	服务内部错误，请稍后重试
400	1051001	request contain invalid param	请求中包含非法参数
403	1051002	request to exceed authority	请求发生越权

{ "code": 0, "msg": "success", "data": { "badges": [ { "id": "m_MzfKDM", "name": "激励勋章", "explanation": "这枚勋章为了激励员工颁发。", "detail_image": "75a1949f-d9df-4b46-bc88-dacc51e88f3j", "show_image": "03daa74a-159f-49e9-963e-b6c4d76103fj", "i18n_name": { "zh_cn": "激励勋章", "en_us": "Incentive Medal", "ja_jp": "奨励メダル" }, "i18n_explanation": { "zh_cn": "激励勋章", "en_us": "Incentive Medal", "ja_jp": "奨励メダル" } } ], "page_token": "h121921", "has_more": false } }

请求参数

Query 参数

page_size

integer

必需

分页大小

示例值：10

默认值：10

数据校验规则：

最大值：50

page_token

string

可选

分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果

示例值："b1fmUz"

name

string

可选

租户内唯一的勋章名称，精确匹配。

示例值："激励勋章"

数据校验规则：

最小长度：1 字符

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

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

badges

array [object {7}]

勋章列表

必需

page_token

string

必需

分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token

has_more

boolean

是否还有更多项

必需

错误码#

请求参数

返回响应

错误码