查询活动指定商品列表API

最新更新时间:2019.11.28 版本说明


商户创建活动后,可以通过该接口查询支付有礼的活动指定商品,用于管理活动。

接口说明

适用对象:微信支付商户 服务商 渠道商

请求URL:https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/{activity_id}/goods

请求方式:GET

接口规则:https://wechatpay-api.gitbook.io/wechatpay-api-v3


path指该参数为路径参数

query指该参数需在请求URL传参

body指该参数需在请求JSON传参


请求参数

参数名 变量 类型[长度限制] 必填 描述
活动id activity_id string[1,20] path活动id
示例值:10028001
分页页码 offset uint64 query 分页页码
示例值:1
分页大小 limit uint64 query 限制分页最大数据条目。
示例值:20

请求示例


https://api.mch.weixin.qq.com/v3/marketing/paygiftactivity/activities/10028001/goods?offset=1
    
{
JAVA示例代码
}
    

返回参数

参数名 变量 类型[长度限制] 必填 描述
+ 结果集 data array 商户信息列表
参数名 变量 类型[长度限制] 必填 描述
指定商品 goods_id string 指定商品(商户sku)
示例值:0345678
创建时间 create_time string[1,32] 创建时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00
更新时间 update_time string[1,32] 更新时间,遵循rfc3339标准格式,格式为YYYY-MM-DDTHH:mm:ss+TIMEZONE,YYYY-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日13点29分35秒。
示例值:2015-05-20T13:29:35+08:00
总数 total_count uint64 商户数量
示例值:30
分页页码 offset uint64 分页页码
示例值:4
分页大小 limit uint64 限制分页最大数据条目。
示例值:20
活动id activity_id string[1,20] 活动id
示例值:126002309

返回示例


{
  "data": [
    {
      "goods_id": "0345678",
      "create_time": "2015-05-20T13:29:35+08:00",
      "update_time": "2015-05-20T13:29:35+08:00"
    }
  ],
  "total_count": 24,
  "offset": 4,
  "limit": 20,
  "activity_id": "10028001"
}

    http://2323weixin.qq.com
                                

错误码公共错误码

状态码 错误码 描述 解决方案
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 签名错误或签名信息不完整 登录商户平台核对,传入正确信息

版本说明

关闭
V1.0
2019年11月28日
1. 创建全场满额送活动API接口上线

技术咨询

反馈有奖