docs: define idempotent Client registration contract (#12)
This commit is contained in:
@@ -372,7 +372,7 @@ CREATE TABLE clients (
|
||||
device_address TEXT,
|
||||
platform TEXT,
|
||||
pdd_package TEXT,
|
||||
capabilities TEXT, -- claim 请求里的 capabilities 原文
|
||||
capabilities TEXT, -- 登记或 claim 请求里的 capabilities 原文
|
||||
last_seen_at TEXT NOT NULL, -- 每次调接口都刷新
|
||||
created_at TEXT NOT NULL,
|
||||
updated_at TEXT NOT NULL
|
||||
@@ -382,8 +382,8 @@ CREATE TABLE clients (
|
||||
- `[必须]` **没有 `status` 字段。** 在线状态是**算出来的**:
|
||||
`last_seen_at` 在 N 分钟内算在线,否则离线。`[建议]` N 默认 10 分钟。
|
||||
存成字段会和真实情况不同步。
|
||||
- `[必须]` 注册发生在**领取任务时**,新序列号新增、已有的更新,
|
||||
**不设单独的注册或心跳接口**,见 [04](04-client-api.md) §3。
|
||||
- `[必须]` 设置页使用独立登记接口幂等新增或更新 Client,claim 保留隐式登记作为兼容兜底。
|
||||
- `[必须]` 不设心跳接口;登记、claim、result 和 failure 都刷新 `last_seen_at`,见 [04](04-client-api.md) §1.1、§3。
|
||||
|
||||
## 9. 数据关系总览
|
||||
|
||||
|
||||
Reference in New Issue
Block a user