admin 发表于 2024-10-31 01:06:12

获取未读系统通知


获取未读系统通知

接口说明:获取发送DZ系统通知后,未读取的系统通知,可用来进行二次开发,给指定用户发送指定,一次性口令。


接口详情
请求地址:http://demo35.xinxiuvip.com/plugin.php?id=xinxiuvip_network:admin
请求方式: GET   
返回格式: JSON\\XML   /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/


请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】)
参数类型是否必含说明示例
adminkey是管理密钥(后台设置)12345
action是接口方法notice_checknew

token是用户登录后token令牌demo
ids否根据本接口命令返回未读通知的id,此参数设置后即为读取此通知



请求示例(GET)
http://demo35.xinxiuvip.com/plugin.php?id=xinxiuvip_network:admin&adminkey={管理密钥}&action=notice_checknew&token={token令牌}


返回参数(所有接口返回数据含中文时“\\u672c\\u6846”,请用USC2进行解码)
参数类型是否必含说明示例
code是http状态码200
result是错误信息状态码OK
count是数组成员数4
data是数组
data>>array是返回未读通知信息,其中id可以通过此接口增加&ids=215来打开215通知内容,并标记已读

sqltime是页面执行时间(秒)1.43499s


返回示例(JSON)
{
      "code": "200",
      "result": "OK",
      "count": 4,
      "data": [{
                "id": "215",
                "dateline": "1730302892",
                "type": "system",
                "category": "3"
      }, {
                "id": "216",
                "dateline": "1730302943",
                "type": "system",
                "category": "3"
      }, {
                "id": "217",
                "dateline": "1730307057",
                "type": "system",
                "category": "3"
      }, {
                "id": "218",
                "dateline": "1730307254",
                "type": "system",
                "category": "3"
      }],
      "sqltime": "0.00349s"
}

{
      "code": "200",
      "result": "OK",
      "count": 1,
      "data": [{
                "id": "215",
                "uid": "1",
                "type": "system",
                "new": "1",
                "authorid": "0",
                "author": "",
                "note": "ceshi",
                "dateline": "1730302892",
                "from_id": "0",
                "from_idtype": "",
                "from_num": "1",
                "category": "3"
      }],
      "sqltime": "0.00401s"
}



额外说明
注意:此接口是DZ内置系统通知功能发送后,用于查询通知是否已读,通过添加&ids来读取未读通知,可用于软件开发时给某个用户发送某种一次性指令。


字段名数据类型默认值允许非空自动递增备注
idmediumint(8) unsigned
NO是通知ID
uidmediumint(8) unsigned0NO
通知用户ID
typevarchar(20)
NO
通知类型:"doing"记录,"friend"好友请求,"sharenotice"好友分享,"post"话题回复,
newtinyint(1)0NO
通知是否为新:"1"为新通知,"0"为通知已读
authoridmediumint(8) unsigned0NO
作者用户ID
authorvarchar(15)
NO
用户名
notetext
NO
通知内容
datelineint(10) unsigned0NO
通知产生的时间戳
from_idmediumint(8) unsigned0NO
来源对象id
from_idtypevarchar(20)
NO
来源对象类型
from_nummediumint(8) unsigned0NO
来源量
categorytinyint(1)0NO
提醒分类 1我的帖子 2坛友互动 3系统消息 4管理工作 0应用消息



错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920

页: [1]
查看完整版本: 获取未读系统通知