账户创建
账户监控产品分为个人账户和企业账户,其中个人账户只能包含自然人,而企业账户可以包含法人和自然人。要创建账户,只需将 Account 类型的对象发送到以下端点之一:
- 个人账户
POST https://api.caas.qitech.app/account_monitoring/natural_person_account
示例
{
"account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
"registration_date": "2019-12-20T15:23:12"
}
- 企业账户
POST https://api.caas.qitech.app/account_monitoring/legal_person_account
示例
{
"account_id": "5ce7fab5-8165-44a5-9b89-bb2d6d61e4f4",
"registration_date": "2019-12-20T15:23:12"
}
注册的所有信息交换均使用以下对象定义。在某些情况下,为了便于实现并减少各方之间的数据流,部分信息可能会被省略。
| 名称 | 类型 | 描述 |
|---|---|---|
| account_id | string | 账户的唯一标识符。 此编号对每个请求必须唯一 |
| registration_date | string (ISO 8601) | 注册的日期和时间。 |
账户停用和重新激活
要在账户监控产品中停用账户,需要在以下端点发送请求,并传入 new_account_status 字段值为 'deactivated':
- 个人账户
PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}
示例
{
"new_account_status" : "deactivated"
}
- 企业账户
PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}
示例
{
"new_account_status" : "deactivated"
}
这将停用账户并中止其监控。要重新激活账户并恢复其监控,只需在以下端点发送请求,此时传入 new_account_status 为 'active':
- 个人账户
PATCH https://api.caas.qitech.app/account_monitoring/natural_person_account/{account_id}
示例
{
"new_account_status" : "active"
}
- 企业账户
PATCH https://api.caas.qitech.app/account_monitoring/legal_person_account/{account_id}
示例
{
"new_account_status" : "active"
}
重新激活账户后,账户主题的监控间隔将重新开始。例如,如果所有主题均每 24 小时监控一次,则在账户重新激活时,更新将在重新激活后 24 小时执行。