API 教程

At 2020-03-14 fate wrote in OpenWebMonitor. 1307 viewer.

前置条件:

  • 理解HTTP请求
  • 指导HTTP请求的两种方式get/post
  • 理解在url中传递参数的格式

what's that???(黑人❓),若以上没概念,则此功能应该不是你的菜。

API功能概述

当出现提醒时,可以将提醒的内容传递给一个url地址,并在url地址参数中附带额外的提醒信息。例如:目标名称、消息、内容。

此功能可以用于将本软件链接到你的其他软件系统中。

教程

  • 进入设置,前往API
  • 勾上已开启此功能
  • 选择请求方式
  • 填写被通知的地址

被通知的地址中,有固定的内容替换关系。

地址中的{target}会被替换成提醒所在的目标的名称,例如”示例天气“。

地址中的{message}会被提示的消息所替换,例如“增加10字,减少65字”。

地址中的{content}会被替换成该目标提醒新版本内容,例如”气温30度,北风7级“。

地址中的{new-content}会被替换为目标内发现的新增的内容。(本条为v4.3.3新增)

地址中的{target-address}会被替换为目标的地址。(本条为v4.3.3新增)

举个例子:

一个名称为”abc“目标,检测发现新的内容为”我就是新内容“,软件的提醒消息为”新增3个字,减少2个字“。 此时,若你的API的通知地址是http://your-address-to-receive-notification.com?fieldA={target}&fieldB={message}&fieldC={content}&fieldD=other

那么实际请求的地址为相应替换后的: http://your-address-to-receive-notification.com?fieldA=abc&fieldB=新增3个字,减少2个字&fieldC=我就是新内容&fieldD=other

注意:

  • 受限于HTTP URL PARAM的长度限制,content若超过150,则会被截断;
  • 所有字段均会被正常的uriEncode;

充分理解以上内容,设置完你的参数后,请点击测试按钮。软件会发送向你的地址发送一个测试请求,并说明结果。

逐条提醒API

v4.3.3 增加此功能

当开启此功能后,API提醒的行为将发生改变。

当你需要监控的是文章链接列表时,开启后,在一次检测中,对发现的每一条新增的链接,均会被独立推送一次API请求。并且,您可以通过以下替换来获得该链接的数据:

地址中的{new-link-title}会被替换为该条链接的文字。

地址中的{new-link-address}会被替换为该条链接的地址。

注意,如果你监控的内容里面没有链接,就不要使用逐条功能。

可以用来做什么

通过此功能配合第三方的接口,可以将提醒内容推送到QQ群、微信群、telegram群、line群、discord等。