概述
DataTower提供了一系列的API,来进行数据的查询使用,您可以通过直接调用API,并传入有效的参数实现与后台UI界面化的查询一致的效果。
使用方法
Open-API的使用与项目直接挂钩,在调用前,您需要在对应的项目中申请Open-API-token,点击【项目管理】,选择您所希望使用open-API的项目的【详情】按钮,进入【项目详情】,找到open-api-token行,当该项目没有生成token时,您可以点击“生成”来为该项目生成一个open-api-token
生成后,将会显示该项目唯一的open-api-token,有效期等同于公司账号的服务期限。您可以点击【更新】来刷新token内容(不会更改有效期,只会变更token的值),或者点击【删除】来移除项目的open-api-token
在获取到项目的open-api-token后,您可以将其作为请求参数之一,配合各个API接口进行查询(注:所有的查询请求均要求POST请求)
为防止恶意请求,DataTower会对OPEN-API的请求频次作如下限制:1秒最多10次,1分钟最多100次。如果超过任一频次,您的请求都会被视为恶意请求,而被拦截。
支持的OPEN-API列表
- 事件分析API、事件分析用户/事件列表详情API
- 留存分析API、留存分析用户列表详情API
- 漏斗分析API、漏斗分析用户列表详情API
- 分布分析API、分布分析用户列表详情API
- 间隔分析API、间隔分析用户列表详情API
- 路径分析API、路径分析用户列表详情API
- 属性分析API、属性分析用户列表详情API
- 用户属性搜索API
请求错误码
下面列举了常规的请求错误码,其他错误码见具体的每个请求API的错误说明
错误码 | 说明 |
4000 | 请求参数错误 |
4010 | 请求未携带token,或token无效 |
5000 |
DT内部错误,请联系DT团队
|