# 查询可分配的sku列表
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。
接口英文名:getAssignSkuIDList
服务商采购商品后,可通过本接口查询已购买资源包可分配的sku列表。
access_token可通过getAccessToken接口获得。
# 1. 调用方式
# HTTPS 调用
GET https://api.weixin.qq.com/wxa/charge/service-provider/package/get_convertible_skus?access_token=ACCESS_TOKEN&orderId=ORDERID&spSpuId=SPSPUID&spSkuId=SPSKUID
# 云调用
- 本接口不支持云调用。
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String Parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
| orderId | string | 是 | - | 要分配的服务商订单ID,如 DD2970445798112968704 |
| spSpuId | string | 是 | - | 服务商采购的批发商品SPU ID |
| spSkuId | string | 是 | - | 服务商采购的批发商品SKU ID |
# 请求体 Request Payload
无
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 说明 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| skuList | objarray | SKU列表 |
# Res.skuList(Array) Object Payload
SKU列表
| 参数名 | 类型 | 说明 |
|---|---|---|
| spuId | string | 可分配的小程序/移动应用商品SPU ID |
| skuId | string | 可分配的小程序/移动应用商品SKU ID |
| skuName | string | 可分配的小程序/移动应用商品SKU名称 |
| bizId | number | 可分配的小程序/移动应用商品业务ID |
| attr | object | SKU属性 |
# Res.skuList(Array).attr Object Payload
SKU属性
| 参数名 | 类型 | 说明 |
|---|---|---|
| duration | number | 有效期(单位:秒) |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
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"
}
]
}
# 6. 错误码
此接口没有特殊错误码,可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
# 7. 适用范围
本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。