获取权益信息

适用版本>=v7.0.2505b.20250529

接口说明：获取指定用户的权益信息，仅支持应用授权

请求说明

请求地址	配置域名+/openapi+/v7/privileges
请求方法	GET
签名方式	KSO-1（配置域名+/openapi不参与签名）
权限要求	获取权益信息（应用授权）kso.privilege.read

请求头（Header）

Header	参数类型	是否必填	说明
X-Kso-Date	string	是	RFC1123 格式的日期，例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-Authorization	string	是	KSO-1 签名值，详见《签名方法》
Authorization	string	是	授权凭证，格式为：Bearer {access_token}

查询参数（Query）

名称	参数类型	是否必填	说明
user_id	string	是	指定用户ID
privilege_ids	string	是	指定权益ID，多个用逗号分隔

响应体（Response）

名称	类型	说明
code	int	错误码
detail	string	详细信息
msg	string	状态信息
data	object	返回信息体
∟ privileges	object[]	权益信息
∟ ∟ privilege_id	string	权益ID
∟ ∟ cache_available	boolean	是否可缓存
∟ ∟ value	string	权益值
∟ ∟ consumed	integer	已消耗的权益值
∟ ∟ expire_time	integer	权益过期时间

响应体示例

{
  "data": {
    "privileges": {
      "string": {
        "privilege_id": "string",
        "cache_available": true,
        "value": "string",
        "consumed": 0,
        "expire_time": 0
      }
    }
  },
  "code": 0,
  "detail": "string",
  "msg": "string"
}