04/29/2024 11:54:53

消息订阅(仅微信渠道支持)

一、 获取订阅消息列表

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.

results matching ""

    No results matching ""