目录
企业可通过此接口查询当前剩余的使用量。
请求方式:GET(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition_quota?access_token=ACCESS_TOKEN
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"total":1000,
"balance":500,
"quota_list":
[
{
"expire_date":1689350400,
"balance":200
},
{
"expire_date":1692028800,
"balance":300
}
]
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
total | 历史累计使用量 |
balance | 剩余使用量 |
quota_list.expire_date | 额度过期时间戳,为过期日的零点,实际过期时间取决于额度的购买时间 |
quota_list.balance | 即将过期额度数量 |
企业可通过此接口查询指定获客链接在指定时间范围内的访问情况。
请求方式:POST(HTTPS)
请求地址:https://qyapi.weixin.qq.com/cgi-bin/externalcontact/customer_acquisition/statistic?access_token=ACCESS_TOKEN
请求示例
{
"link_id":"caxxxxxxx",
"start_time":1688140800,
"end_time":1688486400
}
参数说明:
参数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
link_id | 是 | 获客链接的id |
start_time | 是 | 统计起始时间戳 |
end_time | 是 | 统计结束时间戳 |
注意:
1.统计范围的最小粒度为日,将自动转换为时间戳所在日进行统计,区间为闭区间。
2.仅可查询最近180天内的使用记录,起始和结束时间相差不可超过30天
权限说明:
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"click_link_customer_cnt":1000,
"new_customer_cnt":500,
}
参数说明:
参数 | 说明 |
---|---|
errcode | 返回码 |
errmsg | 对返回码的文本描述内容 |
click_link_customer_cnt | 点击链接客户数 |
new_customer_cnt | 新增客户数 |