账户状态 API 是 TD 系统的一个关键功能，旨在确保获取用户身份信息的准确性和及时性。
通过账户状态 API，我们能够准确识别更加狡猾的欺诈者，这些欺诈者巧妙地运用正常身份和行为，以规避关键业务节点的检测，从而欺骗系统。仅凭单一的业务行为判断往往难以揭示欺诈者的真实意图。
此外，账户状态 API 的应用将提高我们对正常用户偶发异常行为的准确识别能力，从而在降低误报率的同时提升用户转化率。我们在一般业务节点对用户进行无感知的数据上报，并在关键业务节点做出决策。这种设计有助于减少对用户的干扰，提升用户体验。
通过账户状态 API ，我们能够确保 TD 系统始终获取到最新的用户身份信息，进而提升系统的安全性和可靠性。
示例：https://cn-event.apitd.net/account/v3?partner_code=test_code&partner_key=test_key
一次完整的请求参数通常由两部分字段组成：
将基础字段和业务事件字段结合起来，构成了一次完整的请求参数。这样的设计使得我们能够有效地传递和处理与账户状态相关的业务事件数据，确保账户信息的准确性和安全性。
| 字段 | 类型 | 含义 | 建议 | 备注 |
|---|---|---|---|---|
| channel | String | 渠道标识 | 必须 | 由 TD 分配 |
| session_id | String | 会话 ID | 必须 | 会话 ID 是网站服务器为特定用户在访问期间分配的唯一标识，通常可以用 Cookie、表单字段或 URL 的形式存储 |
| account_id | String | 账户 ID | 条件必须：当账户注册（创建）后必须 | 当账户不存在时可不传 |
| event_time | String | 业务事件真实发生时间 | 必须 | 符合 ISO 8601 标准，格式 YYYY-MM-DDTHH:mm:ss.sssZ ，例如 2021-10-12T14:20:50.521+07:00 |
| event_type | String | 业务事件类别 | 必须 | 枚举值： |
| terminal | Terminal | 终端信息 | 条件必须：如果存在则必须 | |
| ext | Ext | 扩展信息 | 建议 | 与 TD 约定好的扩展信息 |
我们的 API 设计限制了每次请求只能涉及一个业务事件的数据。这意味着您无法同时发起多个不同的业务事件数据请求，例如注册和登录。
为了确保数据的准确性和系统的可靠性，我们建议您按照业务事件的独立性，分别发送业务事件请求。通过单独处理每个业务事件，我们能够更好地管理和跟踪数据的处理过程，避免混淆和冲突。
遵守这一规则将有助于提高系统的性能和可靠性，并确保每个业务事件都能得到正确处理。如果您需要同时处理多个不同的业务事件，我们建议您分别发送独立的请求，以确保数据的完整性和一致性。
以注册事件为例
{
"channel": "test",
"session_id": "abc0123456789",
"account_id": "123456789",
"event_time": "2021-10-12T14:20:50.521+07:00",
"event_type": "register",
"terminal": {
"black_box": "aGPH1658920283672ropYaFxT7",
"ip": "210.20.10.33"
},
"ext": {
"ext_book_id": "LFOUHOFHOHFNOUH",
"ext_book_num"
API 状态码
{
"code": 200,
"message": "",
"sequence_id": "1648777165770866F82AC7F326307055"
}