云眼全栈API Webhook使用手册

当用云眼全栈API在服务器端做AB测试时,需要将AB测试JSAN格式的配置文件放在服务器本地,而不是每次都从CDN网络上获取,以便减少网络延时,提高AB测试性能。为了解决将JSAN格式的配置文件放在服务器本地后的更新问题,云眼提供了Webhook这一功能特性,通过自动化手段提高AB测试实施的效率。

添加webhook

如果正在用服务器端应用程序管理数据文件,建议配置Webhook来维护最新版本的数据文件,Webhook 就是用户通过自定义回调的方式来改变 Web 应用的一种行为。在云眼平台,用户设置Webhook URL ,只要数据文件被更新,云眼即发送行为通知到用户指定的 URL 中去。必须重新实例化SDK中的Eyeofcloud对象,以使更改生效。

打开云眼控制台(app.eyeofcloud.com),登录后点击“业务优化”,Webhook,点击新建,按照提示添加需要设置的webhook URL 。

添加webhook
添加webhook

填写完成之后,点击确定按钮,保存设置成功的Webhook。

webhook

这样,当datafile更新的时候,云眼服务器就会向用户指定的URL发送post请求,云眼支持设置多个Webhook ,开发者重复上述操作即可。

webhook消息格式

云眼针对第三方的Webhook服务开发,当云眼向服务器发送事件时,使用HTTP POST请求,Content-Type为application/json,数据格式为JSON,Webhook的有效负载结构如下:

{
    "project_id": 1234,
    "timestamp": 1468447113,
    "event": "project.datafile_updated",
    "data": {
        "revision": 1,
        "origin_url": "https://eyeofcloud.s3.amazonaws.com/json/1234.json",
        "cdn_url": "https://cdn.eyeofcloud.com/json/1234.json"
    }
}

目前,云眼平台只支持project.datafile_update一种事件类型。

第三方Webhook服务可以使用获取POST数据的方式来获取消息数据。例如,在python中可以导入request库,然后再调用get_json()方法来获取数据,之后第三方Webhook服务可将数据进行处理,根据“cdn_url”来重新实例化Eyeofcloud对象,获取最新版本的datafile。

免费试用,转化率提升就是这样简单快速 立即试用