适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/marketing/partnerships
请求方式：GET
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| +合作方信息 | partner | object | 否 | query 合作方相关的信息，商户自定义字段。 |
| +被授权数据 | authorized_data | object | 是 | query 被授权的数据。 |
| 分页大小 | limit | uint64 | 否 | query
分页大小，最大50。 不传默认为20。 示例值：5 |
| 分页页码 | offset | uint64 | 否 | query
分页页码，页码从0开始。 示例值：10 |
https://api.mch.weixin.qq.com/v3/marketing/partnerships?authorized_data=%7b%22business_type%22%3a%22BUSIFAVOR_STOCK%22%7d&partner=%7b%22type%22%3a%22APPID%22%7d&offset=0&limit=5
说明： authorized_data ， partner 字段需经过 url 编码后传入即可
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| +合作关系结果集 | data | array | 否 | 合作关系查询结果集。如查询结果为0，将在控制流返回错误 |
| 分页大小 | limit | uint64 | 是 | 分页大小，最大50。 示例值：5 |
| 分页页码 | offset | uint64 | 是 | 分页页码，页码从0开始。 示例值：10 |
| 总数量 | total_count | uint64 | 否 | 总数量，当offset=0时返回。 示例值：1234 |
{
"data":[{
"authorized_data":{
"business_type":"FAVOR_STOCK",
"stock_id":"2433405"
},
"partner":{
"appid":"wx4e1916a585d1f4e9",
"type":"APPID"
},
"update_time":"2015-05-20T13:29:35.120+08:00",
"create_time":"2015-05-20T13:29:35.120+08:00",
"build_time":"2015-05-20T13:29:35.120+08:00",
"terminate_time":"2015-05-20T13:29:35.120+08:00"
},
{
"authorized_data":{
"business_type":"FAVOR_STOCK",
"stock_id":"2433405"
},
"partner":{
"appid":"wx4e1916a585d1f4e9",
"type":"APPID"
},
"update_time":"2015-05-20T13:29:35.120+08:00",
"create_time":"2015-05-20T13:29:35.120+08:00",
"build_time":"2015-05-20T13:29:35.120+08:00",
"terminate_time":"2015-05-20T13:29:35.120+08:00"
}
],
"offset":0,
"total_count":2,
"limit":5
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 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 | 签名错误或签名信息不完整 | 登录商户平台核对，传入正确信息 |