适用对象:直连商户
请求URL:https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/{activity_id}/merchants
请求方式:GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
活动id | activity_id | string[1,20] | 是 | path活动id 示例值:10028001 |
分页页码 | offset | uint64 | 否 | query
分页页码,页面从0开始 示例值:1 |
分页大小 | limit | uint64 | 否 | query
限制分页最大数据条目。 示例值:20 |
https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/merchants?offset=1&limit=20
参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
---|---|---|---|---|
+ 结果集 | data | array | 否 | 商户信息列表 |
总数 | total_count | uint64 | 是 | 商户数量 示例值:30 |
分页页码 | offset | uint64 | 是 | 分页页码 示例值:4 |
分页大小 | limit | uint64 | 是 | 限制分页最大数据条目。 示例值:20 |
活动id | activity_id | string[1,20] | 是 | 活动id 示例值:126002309 |
{
"data": [
{
"mchid": "6002309",
"merchant_name": "良品铺子",
"create_time": "2015-05-20T13:29:35+08:00",
"update_time": "2015-05-20T13:29:35+08:00"
}
],
"total_count": 30,
"offset": 4,
"limit": 20,
"activity_id": "126002309"
}
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系统错误 | 请使用相同参数稍后重新调用 |
400 | PARAM_ERROR | 参数错误 | 根据错误提示,传入正确参数 |
403 | NO_AUTH | 商户未被授权 | 登录商户平台核对,传入正确信息 |
429 | FREQUENCY_LIMITED | 频率超限 | 请求量不要超过接口调用频率限制 |
400 | INVALID_REQUEST | 请求参数符合参数格式,但不符合业务规则 | 根据错误提示,传入符合业务规则的参数 |
400 | MCH_NOT_EXISTS | 商户号不存在 | 请确认发券商户号信息是否有误 |
404 | RESOURCE_NOT_EXISTS | 资源不存在或无可用 | 请确认资源均存在且可用 |
400 | APPID_MCHID_NOT_MATCH | appid与mchid不匹配 | 请确认appid是否正确填写 |
401 | SIGN_ERROR | 签名错误或签名信息不完整 | 登录商户平台核对,传入正确信息 |