TapCub 当前开放的 HTTP 接口都用于数据采集：把网页、服务端和日志里的行为写进你的项目。报表查询、数据导出等能力请在控制台中使用；更多开放接口会在稳定后陆续提供。

接口一览

接口	用途	凭证
浏览器采集	网页脚本上报页面浏览和事件	公开的站点标识，不需要密钥
服务端事件	从你的服务端上报下单、登录等行为事件	绑定项目的 wck_ 密钥
日志导入	批量导入网关或服务器的访问日志	绑定项目的 wck_ 密钥

所有接口都挂在 /api/v1 下，路径里的 v1 就是版本号，没有单独的版本请求头。

先用 SDK

大多数场景不需要直接调用这些接口：

• 网站用 JavaScript（w.js），页面浏览、会话和来源会自动采集。
• 服务端优先用 服务端 SDK，它已经处理了批量发送、重试和去重。

只有在没有对应语言的 SDK、或要从网关直接推送数据时，才建议按本节文档自己发请求。

接入顺序

创建密钥

在控制台的项目设置里创建 API 密钥，权限只勾选需要的采集范围。见 认证与密钥。

发一条测试事件

用调试模式发送一条事件，确认返回里没有错误和警告。

在实时报表里核对

打开控制台的实时页面，确认事件已经到达，再接入正式流量。

请求格式、错误码和频率限制见 通用约定、错误码与限流。