回调接口

设置回调地址

功能说明

设置并校验回调地址,JIoT 设备上报的事件将以回调的形式发给业务服务器。

操作路径

Step1:登入控制台 Step2:进入具体的产品页面 Step3:左侧菜单中选择[回调设置] Step4:点击选择需要使用的回调接口

设置回调地址

在控制台填写回调地址,回调地址必须以 http:// 或 https:// 开头,不支持自定义端口。填写回调地址后需校验通过后才可以使用,

校验规则:

极光将给回调 URL 发起一个 GET 请求并附带一个 8 位随机字符串的参数 echostr,开发者需要在 Response Body 里将 echostr 的 value 返回。

事件回调格式

回调方式说明

当有回调消息时,将采用 HTTP POST 的方式向开发者填写的回调 URL 提交通知消息。需要注意的是,如果回调失败,那么极光将会立即重试一次。

参数说明:

关键字 类型 选项 含义 说明
product_key string 产品的product key
report_seq int 上报事件的序号
device_name string 设备的 device_name
event json 上报事件的结构体
name string 事件的名称
content string 事件的内容
time int 事件发生的时间戳
type int 事件的类型 0:信息,1:告警, 2:故障

消息回调格式

当个消息送达设备的时候,结果会通过 http 回调的方式发送给客户的系统。目前只支持将成功的记录通知到客户。

参数说明:

关键字 类型 选项 含义 说明
product_key string 产品的product key
device_name string 设备的 device_name
message_id int 消息发送时返回该消息的消息 id
msg_status int 0:成功,其他:失败
time int 事件发生的时间戳