1. 接口描述
接口请求域名: rce.tencentcloudapi.com 。
事件信息上报
默认接口请求频率限制:1000次/秒。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数,本接口取值:ReportEvent。 |
| Version | 是 | String | 公共参数,本接口取值:2026-01-30。 |
| Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
| EventCode | 是 | String | 事件码,标准事件包含: 枚举值:
自定义事件可与RCE约定后进行风险评估 示例值:login |
| EventTime | 是 | String | 事件的发生时间 参数格式:符合ISO 8601标准的带UTC时区的毫秒级时间 示例值:2026-07-07T15:16:31.000+08:00 |
| SessionId | 是 | String | 用户当前会话 ID, 用于关联用户登录前后的动作,如果没有传UserId,则SessionId必传,如缺失则可填充空字符串 示例值:se****************56 |
| DeviceToken | 是 | String | 用户设备指纹token标识,在您的网站或者应用程序中集成设备指纹的SDK后获取 示例值:v3:**********************************************************************************************bzxeC9FTtHon0Vq+zEB0iKhM5OGvG |
| UserIp | 是 | String | 客户端 IP 地址(IPv4或IPv6) 示例值:192.***.*.100 |
| EventDetail | 是 | EventDetail | 事件详情,根据您输入的事件码传入对应的事件信息 |
| UserId | 否 | String | 用户在您系统中的唯一ID 示例值:u*******56 |
| UserEmail | 否 | String | 用户邮箱 示例值:u***********.com |
| UserPhone | 否 | String | 用户提供的联系方式 参数格式:符合E.164标准的带“+”、地区编码和号码的格式 示例值:+86138******** |
| Browser | 否 | Browser | web浏览器相关信息,若您已集成我们的设备指纹SDK,则无需传入此字段 |
| App | 否 | App | 应用程序、操作系统和移动设备详细信息,若您已集成我们的设备指纹SDK,则无需传入此字段 |
| DataAuthorization | 否 | DataAuthorization | 数据授权信息,国内地域必填 |
| UserPhoneEncrypt | 否 | String | 手机号码加密方式,国内地域必填 枚举值:
示例值:plain |
| WeChatOpenId | 否 | String | 微信开放账号 示例值:ob************************8E |
| QQOpenId | 否 | String | QQ开放账号 示例值:cs****w |
| QQAppId | 否 | String | QQ应用ID,当传入QQ开放账号时,该字段必填,QQ分配给网站或应用的AppId,用来唯一标识网站或应用 示例值:1****74 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 登陆事件信息上报示例
输入示例
POST / HTTP/1.1
Host: rce.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ReportEvent
<公共请求参数>
{
"EventCode": "login",
"EventTime": "2026-07-07T15:16:31.000+08:00",
"SessionId": "se****************56",
"DeviceToken": "v3:**********************************************************************************************bzxeC9FTtHon0Vq+zEB0iKhM5OGvG",
"UserIp": "192.***.*.100",
"EventDetail": {
"Login": {
"UserInfo": {
"UserLevel": "golden",
"UserPoint": {
"Point": 10,
"PointType": "credit_point"
},
"UserType": "person"
},
"UserLoginName": "u_cuidq",
"LoginResult": {
"Status": "success"
}
}
},
"UserId": "u*******56",
"UserEmail": "u***********.com",
"UserPhone": "+86138********",
"Browser": {
"UserAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36",
"AcceptLanguage": "zh-CN,zh;q=0.9,en;q=0.8",
"ContentLanguage": "zh-CN"
},
"App": {
"OS": "iOS",
"OSVersion": "16.0",
"DeviceManufacturer": "Apple",
"DeviceModel": "iPhone 14 Pro",
"DeviceId": "de*************23",
"AppName": "MyShoppingApp",
"AppVersion": "3.2.1",
"ClientLanguage": "zh-CN"
},
"DataAuthorization": {
"DataProviderName": "**公司",
"DataRecipientName": "腾讯云计算(北京)有限责任公司",
"UserDataType": [
1
],
"IsAuthorized": true,
"IsOrderHanding": true,
"AuthorizationDeadline": 1793070635,
"PrivacyPolicyLink": "http://*******.com"
},
"UserPhoneEncrypt": "plain",
"WeChatOpenId": "ob************************8E",
"QQOpenId": "cs****w",
"QQAppId": "1****74"
}
输出示例
{
"Response": {
"RequestId": "374aefc2-99e7-40a1-b92c-9e08a3f3b742"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| InternalError.SystemException | 系统异常。 |
| InvalidParameter | 参数错误。 |
| InvalidParameter.FieldMissed | 必填字段缺失。 |
| InvalidParameter.InvalidFormat | 字段格式错误。 |
| InvalidParameter.InvalidValue | 字段非法取值。 |
| InvalidParameter.LengthExceed | 字段长度超过最大限制。 |
| InvalidParameterValue.DataUnauthorized | 数据未授权,请检查数据授权信息。 |
| InvalidParameterValue.DuplicatedKey | 自定义参数Key不允许重复。 |
| InvalidParameterValue.EventNotExist | 事件不存在。 |
| InvalidParameterValue.InvalidEventTime | EventTime与当前系统时间相差过大 |
| InvalidParameterValue.TenantNotExist | 租户不存在。 |
| MissingParameter | 缺少参数错误。 |
| MissingParameter.FieldMissed | 缺少参数错误,必传参数未填。 |
| UnauthorizedOperation | 未授权操作。 |