清晰的接口。 受控的访问。
事件流
可以信赖的事件。
持仓、订单、成交、报价和风险在发生时通过一条事件流送达。每条消息都有编号,客户端一旦漏收便能立即察觉。
REST API
一个带版本的 API。
账户、订单与成交、投资组合、风险和提醒,统一在一个带版本的 REST API 之下,登录后可查看 OpenAPI 参考文档。
访问
按角色授予访问。
从管理员到只读,角色决定每个调用方可以查看和执行的内容。只读角色无法下单或撤单。
没有长期有效的密钥。 这是有意的设计。
用令牌,不用密钥。
我们有意移除了 API 密钥认证。携带密钥的请求会被拒绝,并被要求出示签名令牌。
每次调用都经过认证。
API 参考文档也不例外;唯一开放的是经过脱敏的公开状态页。Web 层还提供严格传输安全(HSTS)、内容安全策略、跨站请求防护和速率限制。
经纪密钥留在系统内。
只有 Adaptic 的内部服务身份可以读取已存储的经纪商和供应商密钥。任何用户、浏览器或匿名调用方都无法读取它们,也无法按其筛选或排序。
记录哪些内容。
登录失败、操作员操作,以及通过数据服务进行的每一次写入,连同操作人、时间和变更字段一并记录。已存储的凭据在记录中会被隐去。
携带 API 密钥的请求
GET /api/v1/portfolioX-API-Key: sample_key_… 401 Unauthorized{ "error": { "code": "API_KEY_AUTH_UNSUPPORTED", "message": "API key authentication is not supported; present an engine-issued JWT (Authorization: Bearer <jwt>)" }}API 调用提出请求。 由检查来决定。
通过任何接口发送的订单,都要像引擎发出的订单一样,通过相同的交易前检查和账户交易政策。每个订单客户端只绑定一个账户,该账户的交易一旦关闭便会拒绝;开仓暂停会拦截一切增加风险的操作,而平仓和保护性止损照常通过。
每个事件都有序。 每个事件都可追溯。
事件流上的每条消息都使用同一个信封:事件、数据、账户、将其与触发操作关联的关联 ID、时间戳和序列号。