获取服务用户有效期列表

查看 Markdown

最后一次编辑于 2026-07-04

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南。

接口英文名:get_service_buyer_list

本接口用于获取服务用户有效期列表

对于普通业务,access_token为第三方平台component_access_token 对于设计工具类业务,access_token为服务平台的企业主页的access_token

1. 调用方式

HTTPS 调用

POST https://api.weixin.qq.com/wxa/servicemarket/service/get_service_buyer_list?access_token=ACCESS_TOKEN

云调用

  • 本接口不支持云调用。

第三方调用

2. 请求参数

查询参数 Query String Parameters

参数名类型必填示例说明
access_tokenstring是ACCESS_TOKEN接口调用凭证,可使用 component_access_token

请求体 Request Payload

参数名类型必填说明
service_idnumber是服务id,64位无符号整数
offsetnumber是偏移量
limitnumber是最大为10
buyer_typenumber否买家类型,1是小程序,2是微信用户,默认为1

3. 返回参数

返回体 Response Payload

参数名类型说明
errcodenumber错误码
errmsgstring错误信息
buyer_listobjarray-

Res.buyer_list(Array) Object Payload

参数名类型说明
appidstring小程序appid,buyer_type = 1时返回
service_idnumber服务id,64位无符号整数
spec_listobjarray-
openidstring用户在服务平台的openid,buyer_type = 2时返回

Res.buyer_list(Array).spec_list<Array> Object Payload

参数名类型说明
specification_idstring规格ID
expire_timenumber过期时间

4. 注意事项

本接口无特殊注意事项

5. 代码示例

请求示例

{
    "service_id": 10000000005,
    "offset":0,
    "limit":10,
    "buyer_type":1
}

返回示例

{
    "errcode": 0,
    "errmsg":"ok",
    "buyer_list":
    [
        {
            "appid": "wxb24cc230ace685a3",
            "service_id": 10000000005,
            "spec_list": [
              {
                "expire_time": 1619010767,
                "specification_id": "free"
              },
              {
                "expire_time": 1637987028,
                "specification_id": "pro"
              }
            ]
        },
        {
            "appid": "wxd30af6a6a77d8a32",
            "service_id": 10000000005,
            "spec_list": [
              {
                "expire_time": 1619010768,
                "specification_id": "free"
              },
              {
                "expire_time": 1637987029,
                "specification_id": "pro"
              }
            ]
        }
    ]
}

6. 错误码

此接口没有特殊错误码,可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。

7. 适用范围

本接口支持「小程序」账号类型调用。其他账号类型如无特殊说明,均不可调用。