功能一览
REST API，逐项了解。
通过文档完善、带版本的 API 读写每一条记录。
带版本的 endpoint每个模块都有稳定的 /v1 路径，发布新版本之前会提前告知变更。内置功能
可预期的响应所有响应结构一致：成功时返回数据，出错时返回错误码和提示信息。内置功能
Idempotency key每次写入都带上一个 key，重试请求也不会产生重复记录。同步到 Dika Ops
分页与筛选大列表可以分页读取，并按日期、状态或负责人筛选。从 Dika Ops 同步
限流按令牌设置合理的限额，响应头会告诉你还剩多少额度。内置功能
OpenAPI 描述文件机器可读的规范，可用于代码生成和测试工具。从 Dika Ops 同步
使用场景
团队怎么用它。
01连接你自己的系统
将旧系统或自建门户中的订单直接推送到订单列表。
02为 BI 提供数据
定时把销售、库存和财务数据拉取到你自己的报表工具中。
03开发内部工具
基于同一套记录，为车间或外勤团队开发小型应用。
设置
四步完成连接。
- 01
在“设置”中创建 API 令牌，并选择它的权限范围。
- 02
先阅读参考文档，并在测试公司里试跑你的调用。
- 03
每次写入都带上 Idempotency-Key 请求头，让重试保持安全。
- 04
切换到正式公司环境，并在最初几次运行时留意审计日志。
常见问题
REST API，常见问题。
API 使用什么格式？
基于 HTTPS 的 JSON。日期遵循 ISO 8601，金额以十进制字符串传输，所以每一分钱都不会丢失。
API 能绕过权限吗？
不能。令牌拥有其所属用户或服务的权限，每次调用都会校验。
重试请求会怎样？
只要 idempotency key 相同，就会返回最初的结果，不会重复写入。
有测试环境吗？
有。参与测试的公司会获得一个带示例数据的测试公司，供你对接开发。