10/27/2025 18:02:31
消息订阅(仅微信渠道支持)
一、 获取订阅消息列表
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 © 2025 MSDK.
All rights reserved.
                                
                                All rights reserved.