11/08/2024 16:35:55
消息订阅(仅微信渠道支持)
一、 获取订阅消息列表
1.1 接口名
/v2/profile/subscribe_getlist
1.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 统一账户唯一标识 |
token | string | 【必填】 token |
page | int | 【选填】页码,默认为 0 |
page_size | int | 【选填】每页条数,默认为 10 |
1.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
subscribe_list | array | 订阅消息列表 |
more | bool | 是否还有更多的列表,true:有,false:无 |
1.4 请求示例
- 请求
{ "openid":"5058652921602482984", "token":"19_xBABCDoypXGNWsD0DS_Qp_ThLAJE8HaichHpIgT6PtWMM3-PMH-yB3KlVnyUjM8CsXjDpSu08rdKRoj-PxZ7k9Cv4AIIjZOJBN99FMG6ruM" }
- 响应
{ "subscribe_list":[], "more":false, "ret":0, "msg":"success" }
注意:
1、获取订阅消息列表会返回游戏所有的订阅主题配置,与具体某个账号是否订阅了无关。
2、新的订阅接入,需联系微信订阅产品沟通。具体接口人请咨询 MSDK 助手
二、 批量订阅
2.1 接口名
/v2/profile/subscribe_setlist
2.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【必填】 用户唯一标识 |
token | string | 【必填】 用户的登录态 |
op_type | int | 【必填】 操作类型 0 - 订阅, 1 - 取消 |
msg_id | array | 【必填】 请求的消息ID列表,如 [1,2,3] |
2.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
2.4 请求示例
- 请求
{ "openid":"5058652921602482984", "token":"19_xBABCDoypXGNWsD0DS_Qp_ThLAJE8HaichHpIgT6PtWMM3-PMH-yB3KlVnyUjM8CsXjDpSu08rdKRoj-PxZ7k9Cv4AIIjZOJBN99FMG6ruM", "msg_id":[111,222], "op_type":0 }
- 响应
{ "ret":0, "msg":"success" }
三、 订阅推送
3.1 接口名
/v2/profile/subscribe_push
3.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【选填】 统一账户唯一标识 |
token | string | 【选填】 token |
msg_id | int | 【必填】 请求的消息 ID,如 123 |
3.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
3.4 请求示例
- 请求
{ "openid":"5058652921602482984", "token":"19_xBABCDoypXGNWsD0DS_Qp_ThLAJE8HaichHpIgT6PtWMM3-PMH-yB3KlVnyUjM8CsXjDpSu08rdKRoj-PxZ7k9Cv4AIIjZOJBN99FMG6ruM", "msg_id":123 }
- 响应
{ "ret":0, "msg":"success" }
四、 订阅清理
4.1 接口名
/v2/profile/subscribe_clear
4.2 请求参数
参数 | 类型 | 描述 |
---|---|---|
openid | string | 【选填】 统一账户唯一标识 |
token | string | 【选填】token |
msg_id | int | 【必填】 请求的消息 ID,如 123 |
4.3 返回参数
参数 | 类型 | 描述 |
---|---|---|
ret | int | 返回码 0:正确,其它:失败 |
msg | string | 返回结果详细说明 |
4.4 请求示例
- 请求
{ "openid":"5058652921602482984", "token":"19_xBABCDoypXGNWsD0DS_Qp_ThLAJE8HaichHpIgT6PtWMM3-PMH-yB3KlVnyUjM8CsXjDpSu08rdKRoj-PxZ7k9Cv4AIIjZOJBN99FMG6ruM", "msg_id":123 }
- 响应
{ "ret":0, "msg":"success" }
Copyright © 2024 MSDK.
All rights reserved.
All rights reserved.