通过调用RTX接口发送报警消息

 

一、原理:

通过GET或者POST方式将需要发送的消息和RTX用户帐号,传给RTX提供的cgi接口。

##
二、详细方法:

方法:GET/POST URL:/sendnotify.cgi 用法举例(IE地址栏中输入): http://127.0.0.1:8012/sendnotify.cgi?msg=hello&receiver=wwjs

参数表:

receiver:接收者,用户昵称,多个接收者以“,”隔开。

msg:消息内容 ,如需要发隐式链接,格式如: [明朝网络|http://www.mingchao.com]

title:消息提醒的标题。

delaytime:消息提醒框的停留时间(毫秒),0表示不自动消失。

okurl:成功后IE自动定位到指定的url 格式类似为:okurl=www.mingchao.com或者okurl=http://www.mingchao.com 注意:这里的url必须为绝对地址。

errurl:失败后IE自动定位到指定的url。
功能二:获取用户状态

1.调用方式:http://127.0.0.1:8012/getstatus.php?username=yangbin

2.参数说明: username 需要获取哪个用户的状态
功能三:给某个组群发RTX广播消息

1.调用方式:http://127.0.0.1:8012/sendnotifybydepart.php?receiverdepart=运维开发组&msg=吃饭了&title=通知&online=1&delaytime=10000

2.参数说明: receiverdepart 需要给那个部门发送消息,该部门即在RTX中看到的组织架构中的部门名

msg   消息内容 ,如需要发隐式链接,格式如: [明朝|http://www.mingchao.com]

title 消息提醒的标题。 【可省略】

online 是否只发在线用户,默认只发给在线用户。 【可省略】

delaytime 消息提醒框的停留时间(毫秒),0表示不自动消失,默认为0。 【可省略】

okurl 成功后IE自动定位到指定的url 格式类似为:okurl=rtx.tencent.com 或者okurl=http://tx.tencent.com 注意:这里的url必须为绝对地址。 【可省略】

errurl   失败后IE自动定位到指定的url。【可省略】
功能四:给某个群群发RTX广播消息

1.调用方式:http://127.0.0.1:8012/sendnotifybygroup.php?receivergroup=M4开发群&msg=吃饭了&title=通知&online=1&delaytime=10000

2.参数说明: receivergroup 需要给那个群发送广播消息,即RTX群

msg   消息内容 ,如需要发隐式链接,格式如: [明朝|http://www.mingchao.com]

title 消息提醒的标题。 【可省略】

online 是否只发在线用户,默认只发给在线用户。 【可省略】

delaytime 消息提醒框的停留时间(毫秒),0表示不自动消失,默认为0。 【可省略】

okurl 成功后IE自动定位到指定的url 格式类似为:okurl=rtx.tencent.com 或者okurl=http://tx.tencent.com 注意:这里的url必须为绝对地址。 【可省略】

errurl   失败后IE自动定位到指定的url。【可省略】

##
三、注意事项

(1)参数msg中如果包含中文那么需要将msg的编码方式转换成GBK或者GB2312,msg是不支持UTF-8编码方式的。

(2)参数msg如需要加入超链接格式为:[点我跳转|http://www.mingchao.com]

(3)参数msg中不能出现空格,如果需要空格可用【+】替代。

(4)如果请求的url中包含特殊字符,那么需要使用urlencode(),来对url进行编码,否则可能导致超链接显示不正常。

(5)发送消息是需要权限的,这个需要在RTX服务端配置才能发送消息。

##
四、建议

(1)对msg进行转码的时候用GBK不要用GB2312,因为GB2312支持的汉字比较少,很多比较偏的汉字会无法显示,导致消息被中断(即用户只能收到这个中断前的字符)。

(2)在对消息进行转码的时候,可以考虑加入参数IGNORE,即$msg=iconv(“utf-8”,”gb2312//IGNORE”,$msg)这样在转码的时候将会忽略错误字符。会将错误字符后面的继续转码。

(3)在RTXServer服务端的WebRoot目录下放着很多的cgi和php文件。这些文件都是可以用HTTP方式来访问的,你也可以自己编写新的cgi或者php文件,然后将其放到改目录下即可。这样将可能提供非常强大的扩展功能。

 

本文摘自:http://www.xuebuyuan.com/1269803.html