# 查询可分配的sku列表
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getConvertibleSkus
# 功能描述
- 服务商采购商品后,可通过本接口查询已购买资源包可分配的sku列表。
# 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/charge/service-provider/package/get_convertible_skus?access_token=ACCESS_TOKEN
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。access_token可通过getAccessToken接口获得。 |
orderId | string | 否 | 要分配的服务商订单ID,如 DD2970445798112968704 |
spSpuId | string | 否 | 服务商采购的批发商品SPU ID |
spSkuId | string | 否 | 服务商采购的批发商品SKU ID |
说明:
- 参数orderId 和 spSpuId + spSkuId 可二选一,都传入的情况下优先取orderId。
- 传入orderId时会根据订单获取对应已购买的 spSpuId + spSkuId。
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
skuList | array | SKU列表 |
# SKU
属性 | 类型 | 说明 |
---|---|---|
spuId | string | 可分配的小程序/移动应用商品SPU ID |
skuId | string | 可分配的小程序/移动应用商品SKU ID |
skuName | string | 可分配的小程序/移动应用商品SKU名称 |
bizId | number | 可分配的小程序/移动应用商品业务ID |
attr | object | SKU属性 |
attr.duration | number | 有效期(单位:秒) |
说明:
- 无需关注可分配的小程序/移动应用商品SKU的价格,finalPrice字段已废弃。
# 调用示例
示例说明: HTTPS调用
# 请求数据示例
GET https://api.weixin.qq.com/wxa/charge/service-provider/package/get_convertible_skus?access_token=ACCESS_TOKEN&spSpuId=10000001&spSkuId=20000101
# 返回数据示例
{
"errcode": 0,
"skuList": [
{
"skuId": "20000000",
"spuId": "10000000",
"skuName": "sku name",
"bizId": 100000,
"attr": {
"duration": "31536000",
"granularity": 99,
"proportion": {
"quota": {
"quota": "5000"
}
},
"durationType": 1
},
"finalPrice": "0"
},
{
"skuId": "20000001",
"spuId": "10000000",
"skuName": "sku name2",
"bizId": 100000,
"attr": {
"duration": "31536000",
"granularity": 99,
"proportion": {
"quota": {
"quota": "1000"
}
},
"durationType": 1
},
"finalPrice": "1"
}
]
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
10120002 | 参数错误 | 检查参数 |
10120405 | 方法不可用 | 对照文档使用正确的方法请求 |