# 查询已购资源包的用量情况

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

getSPUsageDetail

# 功能描述

服务商可通过本接口查询已购买资源包的用量情况；

# 调用方式

# HTTPS 调用


GET https://api.weixin.qq.com/wxa/charge/service-provider/usage/get?access_token=ACCESS_TOKEN

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。access_token可通过getAccessToken接口获得。
spuId	string	是	商品SPU ID
offset	number	是	分页偏移量，从0开始
limit	number	是	每页个数，最大20
status	number	否	资源包状态

# 返回参数

参考小程序获取用量接口，返回结构类似。

# 调用示例

示例说明: HTTPS调用

# 请求数据示例

GET https://api.weixin.qq.com/wxa/charge/usage/get?access_token={{SP_ACCESS_TOKEN}}&amp;spuId=10000001&amp;offset=0&amp;limit=10

# 返回数据示例

{
  "errcode": 0,
  "all": "10",
  "effectiveUse": "0",
  "total": 2,
  "detailList": [
    {
      "pkgId": "ZY2823973277692477440",
      "startTime": 1677914190,
      "endTime": 1709450190,
      "used": "0",
      "all": "4",
      "status": 1,
      "spuId": "10000057",
      "skuId": "20000059",
      "orderId": "DD2981741311549200000"
    },
    {
      "pkgId": "ZY2676590816357400576",
      "startTime": 1669129510,
      "endTime": 1700665510,
      "used": "0",
      "all": "6",
      "status": 1,
      "spuId": "10000057",
      "skuId": "20000060",
      "orderId": "DD2981741311549200001"
    }
  ]
}

# 错误码

错误码	错误码取值	解决方案
10120002	参数错误