短消息 - wolfcon/NGA-API-Documents GitHub Wiki
8 收发短消息
8.1 获取短消息列表
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 list
page //页数 整数
__output //输出格式 见1.1
返回数据格式大致解释如下
window.script_muti_get_var_store={
"data":{
"0":{
"0":{
"mid":139382,//消息id
"last_modify":1378975106,//最后更新时间
"bit":0,//消息类型bit 见8.1.1
"subject":"bvgtfrebvhgtrfbehvgrf",//标题
"from":58,//发起人用户id
"time":1378975106,//发起时间
"last_from":58,//最后回复人用户id
"posts":1,//回复数
"from_username":"zeg",//发起人
"last_from_username":"zeg"//最后回复人
},
"1":{
"mid":109771,
"last_modify":1373465880,
"bit":0,
"subject":"你评论的主题被删除",
"from":58,
"time":1373465880,
"last_from":58,
"posts":1,
"from_username":"zeg",
"last_from_username":"zeg"
},
... //可能有多条信息
"rowsPerPage":35,//每页的消息数
"nextPage":1,//是否有下一页
"currentPage":1//当前所在页
}
},
"time":1379063513
}
8.1.1 短消息类型bit mask
短消息类型是一个32位bit数据
bitmask如下
const _MULTI_CONV=1; #是否是多人(2人以上)对话
const _UNREAD=2; #是否有未读内容
8.2 获取短消息内容
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 read
mid //消息id 整数
page //页数 整数 如取-1则为消息的最后一页
__output //输出格式 见1.1
返回数据格式大致解释如下
window.script_muti_get_var_store={
"data":{
"0":{
"0":{
"subject":"xxoo...", //标题
"content":"xxoo...xxoo...", //内容
"from":123245,//发信人uid
"time":1377079518,//发信时间
"id":178492//消息id
},
"1":{
"subject":"",
"content":"xxooxxoo...",
"from":4321,
"time":1377080704,
"id":178498
},
... //可能有多条信息
"userInfo":{//用户数据 此部分与第5节中的 用户数据 部分结构一致
...
},
"starterUid":19936013,//发起短信会话的用户的id
"allUsers":"4321 asd 123245 fds",//参与会话的所有的 用户id 用户名...
"currentPage":1 //当前所在的页
'nextPage':1//是否有下一页
}
},
"time":1378972453
}
8.3 发送新短消息
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 new
subject //消息标题
content //消息内容
to //收信人用户名或用户id 多个收信人用空格或英文逗号分隔
__output //输出格式 见1.1
短消息可以进行多人会话
必须使用post提交数据
8.4 回复短消息
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 reply
mid //欲回复的消息id 整数
subject //消息标题
content //消息内容
__output //输出格式 见1.1
必须使用post提交数据
8.5 向短消息会话中添加更多的参与者
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 add
mid //消息id 整数
to //欲添加的参与者的用户名或用户id 多个用空格或英文逗号分隔
__output //输出格式 见1.1
必须使用post提交数据
8.6 从短消息会话中移除讨论者/退出
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 leave_topic
mid //消息id 整数
luid //欲移除的用户id 整数 只有短消息的发起者 才可以指定将某个用户从会话中移除 其他参与者只能移除自己
__output //输出格式 见1.1
短消息的发起者 可以指定将某个参与者从会话中移除
短消息的其他参与者 可以自己退出会话
退出之后将不能看见此条短消息
必须使用post提交数据
8.7 短消息黑名单添加
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 add_block
buids //欲屏蔽的用户id 整数
__output //输出格式 见1.1
被屏蔽的用户将不能给自己发送新短消息
也不能将自己添加到短消息会话中
必须使用post提交数据
8.8 短消息黑名单解除
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 del_block
buids //欲解除屏蔽的用户id 整数
__output //输出格式 见1.1
取消一个被屏蔽的屏蔽用户
必须使用post提交数据
8.9 短消息黑名单列表
输入地址
/nuke.php
输入参数
__lib //固定取值 message
__act //固定取值 message
act //固定取值 list_block
__output //输出格式 见1.1
列出自己屏蔽的用户 返回的数据大致如下
window.script_muti_get_var_store={
"data":{
"0":{
"0":{
"uid":2342912,//用户id
"username":"tempuser50"//用户名
}
... //可能有多个
}
},
"time":1379264224
}