接口请求域名： rce.intl.tencentcloudapi.com 。
事件信息上报。用于上报您业务中无需实时决策的事件，我们会通过引擎计算、机器学习挖掘风险特征用于实时事件风险评估。
默认接口请求频率限制：1000次/秒。
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| Action | 是 | String | 公共参数，本接口取值：ReportEvent。 |
| Version | 是 | String | 公共参数，本接口取值：2026-01-30。 |
| Region | 是 | String | 公共参数，详见产品支持的 地域列表。 |
| EventCode | 是 | String | 事件码。用于指定业务接入的场景节点。 账号保护产品下的标准事件包含：
交易保护产品下的标准事件包含：
营销保护产品下的标准事件包含：
自定义事件可与RCE约定后进行风险评估 |
| EventTime | 是 | String | 事件的发生时间 参数格式：符合ISO 8601标准的带UTC时区的毫秒级时间 |
| SessionId | 是 | String | 用户当前会话 ID， 用于关联用户登录前后的动作，如果没有传UserId，则SessionId必传，如缺失则可填充空字符串 |
| DeviceToken | 是 | String | 用户设备指纹token标识，在您的网站或者应用程序中集成设备指纹的SDK后获取 |
| UserIp | 是 | String | 客户端 IP 地址（IPv4或IPv6） |
| EventDetail | 是 | EventDetail | 事件详情，根据您输入的事件码传入对应的事件信息 |
| UserId | 否 | String | 用户在您系统中的唯一ID |
| UserEmail | 否 | String | 用户邮箱 |
| UserPhone | 否 | String | 用户提供的联系方式 参数格式：符合E.164标准的带“+”、地区编码和号码的格式 |
| Browser | 否 | Browser | web浏览器相关信息，若您已集成我们的设备指纹SDK，则无需传入此字段 |
| App | 否 | App | 应用程序、操作系统和移动设备详细信息，若您已集成我们的设备指纹SDK，则无需传入此字段 |
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。 |
POST / HTTP/1.1
Host: rce.intl.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"
}
}{
"Response": {
"RequestId": "374aefc2-99e7-40a1-b92c-9e08a3f3b742"
}
}云 API 3.0 提供了配套的开发工具集（SDK），支持多种编程语言，能更方便的调用 API。
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 描述 |
|---|---|
| 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 | 未授权操作。 |
文档反馈