本文档是当前服务端、Android 客户端和管理页面共同遵循的 v1 契约。机器可读版本见 OpenAPI 3.1。
- API 领域对象统一称为
Session、SessionConfig和 pairing code。 - v1 当前采用干净契约,不保留旧字段、旧路径或兼容别名。
- 会话创建是可重试的幂等操作;PIN 只在会话及其重放记录成功落库时消费。
- 所有活动会话都通过 revisioned
sync同步状态和配置。exitPolicy.onAppClose=true时,同一个同步请求还会续期服务端清理租约。 - 客户端日志上传不塞进
sync请求体;它使用独立的批量资源,并通过能力标识协商。管理 Console 的状态和日志事件流只允许管理员会话访问。
- 除本机调试外使用 HTTPS。
- 有 JSON 请求体的请求必须发送
Content-Type: application/json。 - JSON 请求体上限为 16 KiB;服务端拒绝未知字段、畸形 JSON、尾随第二个 JSON 值和不正确的媒体类型。
- 时间使用 UTC RFC 3339 字符串。可选时间没有值时为 JSON
null,不使用空字符串。 - 列表没有成员时为
[],不使用null。 - 服务端响应可以增加字段;客户端必须忽略未知响应字段。
每个 HTTP 响应都带 X-Request-ID。错误响应统一为:
{
"error": {
"code": "pairing_code_invalid",
"message": "code 无效、已使用或已过期",
"retryable": false
},
"requestId": "PZr_xxxxxxxxxxxx"
}客户端逻辑以稳定的 error.code 和 retryable 为准;message 用于展示或诊断,不作为分支条件。限流响应还带 Retry-After。
GET /v1/meta 是客户端建立会话前的能力发现入口。当前协议版本为 1,当前能力为:
idempotent-session-start-v1revisioned-session-config-v1admin-session-control-v1session-config-update-v1session-sync-v1client-state-report-v1client-logs-v1structured-errors-v1session-policy-capabilities-v1
v1 冻结后,兼容变更只能增加可选响应字段、能力标识或新资源;不能改变已有字段含义、把可选字段改为必填、复用错误码表达另一种错误,或改变现有认证方式。
创建会话时,Android 必须在请求中携带 protocolVersion、clientVersion 和
clientCapabilities。能力名称是小写、稳定的客户端事实,不与服务端 features
混用。当前客户端能力包括:session-sync-v1、client-state-report-v1、
client-logs-v1、rescue-routing-v1、route-advertisement-v1、exit-node-v1 和
advanced-prefs-v1。其中 session-sync-v1 是所有会话的必要能力;其余能力按
规范化配置编译出的 policy 结果成为必要或可选能力。服务端在创建 Tailscale auth key
之前完成 policy/capability 检查,缺少必要能力返回不可重试的
client_capability_missing,不会消费 pairing code 或创建 Session。
| 认证名 | 方式 | 使用范围 |
|---|---|---|
| Public | 无 | /healthz、/v1/meta、登录前认证接口、创建会话 |
| Admin session | pinnode_admin_session HttpOnly、SameSite=Strict cookie |
管理接口读取 |
| Admin write | Admin session + X-CSRF-Token + 同源检查 |
管理接口写入、退出 |
| Session bearer | Authorization: Bearer <sessionToken> |
单个会话的读取、绑定、同步和停止 |
| Idempotency | Idempotency-Key: <16..128 visible ASCII without whitespace> |
POST /v1/sessions 必填 |
首次管理员注册默认只允许服务端本机发起;远程管理登录和凭据保存要求 HTTPS。登录和注册还需要先完成 /v1/auth/pow 返回的工作量证明。
| 方法 | 路径 | 调用者 | 认证 | 用途 |
|---|---|---|---|---|
GET |
/healthz |
运维 | Public | 存活检查 |
GET |
/v1/meta |
Android/工具 | Public | 协议和能力发现 |
GET |
/v1/auth/state |
管理页 | Public/Admin | 管理员初始化和登录状态 |
GET |
/v1/auth/pow |
管理页 | Public | 获取登录工作量证明 |
POST |
/v1/auth/setup |
管理页 | Public + PoW | 首次创建管理员 |
POST |
/v1/auth/login |
管理页 | Public + PoW | 管理员登录 |
POST |
/v1/auth/logout |
管理页 | Admin write | 管理员退出 |
GET |
/v1/tailscale-credentials |
管理页 | Admin session | 列出凭据元数据 |
POST |
/v1/tailscale-credentials |
管理页 | Admin write | 验证并加密保存凭据 |
PUT |
/v1/tailscale-credentials/{credentialId} |
管理页 | Admin write | 验证并轮换凭据,保留已有 PIN 和会话引用 |
POST |
/v1/pairing-codes |
管理页 | Admin write | 创建一次性六位 PIN |
GET |
/v1/admin/console |
管理页 | Admin session | 查询待兑换 PIN、活动会话和控制面快照 |
GET |
/v1/admin/console/stream |
管理页 | Admin session | 订阅 Console 状态事件 SSE |
POST |
/v1/admin/sessions/{sessionId}/stop |
管理页 | Admin write | 复用清理租约远程结束指定会话 |
GET |
/v1/admin/logs/recent |
管理页 | Admin session | 查询进程内最近结构化日志 |
GET |
/v1/admin/logs/stream |
管理页 | Admin session | 订阅结构化日志 SSE |
POST |
/v1/sessions |
Android | Public + Idempotency | 兑换 PIN 并创建会话 |
GET |
/v1/sessions |
管理页 | Admin session | 查询会话历史 |
GET |
/v1/sessions/{sessionId} |
Android/工具 | Session bearer | 读取当前会话 |
POST |
/v1/sessions/{sessionId}/device |
Android | Session bearer | 绑定精确 Tailscale 节点并启用路由 |
PATCH |
/v1/sessions/{sessionId}/config |
管理页 | Admin write | 以 expectedRevision 修改服务端期望配置 |
POST |
/v1/sessions/{sessionId}/sync |
Android | Session bearer | 上报已应用 revision、续期并获取配置 |
POST |
/v1/sessions/{sessionId}/logs |
Android | Session bearer | 上传脱敏后的客户端结构化日志批次 |
POST |
/v1/sessions/{sessionId}/stop |
Android | Session bearer | 撤销路由并删除节点 |
pairing code 请求中的 config 是对安全默认值的部分覆盖;服务端校验和规范化后,总是返回完整快照。默认配置仅发布当前 Wi-Fi 网关 /32。
| 字段 | 类型 | 默认值 |
|---|---|---|
networkMode |
"default" | "cellular" |
"cellular" |
vpnEnabled |
boolean | true |
acceptRoutes |
boolean | true |
acceptDNS |
boolean | true |
tailscaleIp |
string | "" |
useExitNode |
boolean | false |
exitNodeId / exitNodeIp / autoExitNode |
string | "" |
exitNodeAllowLanAccess |
boolean | false |
subnetRouter |
boolean | true |
autoGatewayRoute |
boolean | true |
autoWiFiSubnetRoute |
boolean | false |
advertiseRoutes |
string[] | [] |
advertiseExitNode |
boolean | false |
disableSNAT |
boolean | false |
noStatefulFiltering |
boolean | false |
shieldsUp |
boolean | false |
runSSHServer |
boolean | false |
runWebClient |
boolean | false |
postureChecking |
boolean | false |
remoteConfig |
boolean | false |
hostname |
string | "" |
netfilterMode |
"" | "on" | "off" | "nodivert" |
"" |
appConnector |
boolean | false |
exitPolicy |
ExitPolicy |
全部关闭 |
tailscaleIp 非空时必须是可分配的 Tailscale IPv4;节点加入后由服务端通过 Tailscale API 设置。useExitNode=true 时必须且只能指定 exitNodeId、exitNodeIp、autoExitNode 之一;当前 autoExitNode 只支持 auto:any。autoGatewayRoute 与 autoWiFiSubnetRoute 不能同时启用。advertiseRoutes 最多 16 条,必须是规范化网络 CIDR;默认路由只在 advertiseExitNode=true 时允许。
ExitPolicy:
{
"onAppClose": false,
"networkChange": "",
"afterConfigSeconds": 0,
"afterLoginSeconds": 0,
"at": ""
}networkChange 可为 ""、"any-change"、"wifi-lost"、"cellular-lost"。多个时间策略同时存在时,最早时间生效。
会话有 provisioning、active、cleaning、stopped、cleanup_failed 五种状态。configRevision 是服务器期望配置版本,appliedConfigRevision 是客户端最近通过 sync 确认的版本。
GET /healthz:
{"status":"ok"}GET /v1/meta:
{
"apiVersion": "v1",
"protocolVersion": 1,
"features": [
"idempotent-session-start-v1",
"revisioned-session-config-v1",
"session-sync-v1",
"client-state-report-v1",
"client-logs-v1",
"structured-errors-v1",
"session-policy-capabilities-v1"
],
"limits": {
"jsonBodyBytes": 16384,
"clientLogsBodyBytes": 131072,
"clientLogEntries": 32,
"clientLogMessageBytes": 2048
}
}GET /v1/auth/state 返回 setupRequired、setupAllowed、authenticated;已登录时还返回 username、csrfToken、expiresAt。
GET /v1/auth/pow 返回 id、challenge、difficulty、expiresAt。客户端寻找十进制 powNonce,使 SHA-256(challenge + ":" + powNonce) 至少有 difficulty 个前导零位。
POST /v1/auth/setup 与 POST /v1/auth/login 请求相同:
{
"username": "admin",
"password": "a long password",
"powId": "...",
"powNonce": "12345"
}成功后设置管理员 cookie,并返回 authenticated、username、csrfToken、expiresAt。setup 成功为 201,login 成功为 200。POST /v1/auth/logout 无请求体,成功为 204 No Content。
GET /v1/tailscale-credentials 只返回元数据,绝不返回 token 或 client secret:
{
"credentials": [{
"id": "credential-id",
"name": "家庭 Tailnet",
"type": "oauth_client",
"createdAt": "2026-08-26T08:00:00Z",
"lastUsedAt": null
}]
}POST /v1/tailscale-credentials 支持:
{"name":"临时 API token","type":"api_token","token":"tskey-api-..."}{"name":"长期 OAuth","type":"oauth_client","clientId":"...","clientSecret":"..."}OAuth 交换会显式请求 auth_keys devices:core devices:routes scope 和当前构建的受管设备 tag;服务端检查 token 响应的 scope,并用列出 auth keys 做无副作用的凭据/tailnet 探测。成功为 201,响应是单个凭据元数据对象。
PUT /v1/tailscale-credentials/{credentialId} 使用相同的完整请求体轮换已有凭据。
需要管理员 Cookie、CSRF、同源验证和 HTTPS(仅服务端 loopback 可用 HTTP)。新凭据必须
属于同一 Tailnet,并拥有现有节点所需权限。在线验证失败时不替换旧 secret;成功为 200,
保留 ID、创建时间、既有 PIN 和 session 引用,替换密文并更新 OAuth 缓存。响应只包含元数据。
不存在的 ID 返回 404 credential_not_found;名称冲突返回 409 credential_name_conflict。
基础验证不证明所有既有设备的 routes/core 权限,轮换后仍需核对受管节点。
POST /v1/pairing-codes:
{
"credentialId": "credential-id",
"config": {
"networkMode": "default",
"exitPolicy": {"onAppClose": true}
}
}config 可省略;若提供则必须是对象。它是部分覆盖,不是完整替换。成功为 201,返回六位 code、expiresAt 和规范化后的完整 config。
POST /v1/sessions 必须带 Idempotency-Key:
{
"code": "123456",
"gatewayRoute": "192.168.1.1/32",
"wifiSubnetRoute": "192.168.1.0/24",
"protocolVersion": 1,
"clientVersion": "0.2.0",
"clientCapabilities": [
"session-sync-v1",
"client-state-report-v1",
"client-logs-v1",
"rescue-routing-v1",
"route-advertisement-v1",
"exit-node-v1",
"advanced-prefs-v1"
]
}成功为 201:
{
"protocolVersion": 1,
"serverFeatures": ["idempotent-session-start-v1", "revisioned-session-config-v1", "admin-session-control-v1", "session-config-update-v1", "session-sync-v1", "client-state-report-v1", "client-logs-v1", "structured-errors-v1", "session-policy-capabilities-v1"],
"sessionId": "...",
"sessionToken": "...",
"authKey": "tskey-auth-...",
"provisioningHostname": "pinnode-...",
"configRevision": 1,
"syncIntervalSeconds": 60,
"gatewayRoute": "192.168.1.1/32",
"routes": ["192.168.1.1/32"],
"wifiRoutes": ["192.168.1.1/32"],
"config": {"...":"完整 SessionConfig"},
"expiresAt": null
}同一幂等键和同一规范请求会返回完全相同的敏感响应,并带 Idempotent-Replayed: true;同一键用于不同请求返回 409 idempotency_key_conflict。重放密文只保留到供应期限,设备成功绑定后删除。客户端必须在未知结果的网络失败中持久保存并复用同一键。
Tailscale auth key 创建成功后,服务端在一个 SQLite 事务中消费 PIN、写入会话并写入加密重放响应。校验失败、凭据失败或 Tailscale 上游失败不会消费 PIN。
GET /v1/sessions?limit=100 返回管理端历史记录,limit 为 1..1000。每项包含公开会话字段,以及 authKeyId、provisioningHostname、provisioningDeadline、lastSeenAt、syncDeadline、stoppedAt、stopReason、cleanupError。
GET /v1/sessions/{sessionId} 使用 session bearer,返回路由、完整配置、configRevision、appliedConfigRevision、设备、状态、创建时间和可空的 expiresAt。
POST /v1/sessions/{sessionId}/device:
{"nodeId":"node-id"}服务端验证节点 tag、非 ephemeral 属性、供应 hostname 和创建时间,再只为该精确节点启用本会话路由。重复绑定同一节点是幂等成功,并返回 sessionId、最新的 configRevision、完整 config、expiresAt、nodeId、gatewayRoute、routes、wifiRoutes 和 enabled:true。这组字段是 provisioning 阶段管理员修改配置后,Android 绑定时取得服务端权威快照的唯一来源;客户端不能继续使用旧的 POST /v1/sessions 响应覆盖它。
POST /v1/sessions/{sessionId}/sync 对所有 active 会话可用。除了 revision 和能力列表,客户端可以在每次心跳中提交 clientState;当前 Android 客户端总是提交该快照:
{
"protocolVersion": 1,
"appliedConfigRevision": 1,
"clientVersion": "0.2.0",
"clientCapabilities": ["session-sync-v1", "client-state-report-v1", "client-logs-v1", "rescue-routing-v1", "route-advertisement-v1", "exit-node-v1", "advanced-prefs-v1"],
"clientState": {
"backendState": "running",
"tailscaleRunning": true,
"vpnEnabled": true,
"networkMode": "cellular",
"tailscalePath": "cellular",
"wifiConnected": true,
"cellularConnected": true,
"internetAvailable": true,
"interfaceName": "wlan0",
"tailscaleIps": ["100.64.0.10"],
"allowedIps": ["100.64.0.10/32"],
"advertisedRoutes": ["192.168.1.1/32"],
"deviceName": "Android",
"deviceModel": "test",
"os": "android",
"osVersion": "16",
"health": [],
"lastError": ""
}
}响应:
{
"protocolVersion": 1,
"serverFeatures": ["idempotent-session-start-v1", "revisioned-session-config-v1", "admin-session-control-v1", "session-config-update-v1", "session-sync-v1", "client-state-report-v1", "client-logs-v1", "structured-errors-v1", "session-policy-capabilities-v1"],
"status": "active",
"serverTime": "2026-08-26T08:01:00Z",
"nextSyncAfterSeconds": 60,
"syncDeadline": null,
"desiredConfig": null
}当客户端 revision 落后时,desiredConfig 是包含 revision、完整 config、gatewayRoute、routes、wifiRoutes、expiresAt 的原子快照。客户端先完整应用快照,再在下一次 sync 上报新的 appliedConfigRevision。onAppClose=true 时 syncDeadline 为租约截止时间;其他会话为 null,但仍必须同步以接收配置。
POST /v1/sessions/{sessionId}/logs 使用 session bearer,只接受活动会话和最多 32 条日志。日志上传接口的请求体上限为 128 KiB;通用 JSON 接口上限仍为 16 KiB。单条日志字段为 timestamp(必填 RFC 3339)、level(DEBUG、INFO、WARN、ERROR)、component(最多 128 字节)和 message(最多 2048 字节)。服务端会再次脱敏后再放入日志环,不信任客户端已经做过的脱敏。
Android 客户端在本地保留最多 200 条或约 256 KiB 的待上传日志;正常约每 5 秒发送最多 8 条,ERROR 会唤醒立即发送。每条待上传日志保留所属 session,不能改绑到后续 session;session 结束时未成功上传的条目会被丢弃。上传失败不会停止 VPN,会在下一个窗口重试;进程退出时只做一次有界的尽力 flush。服务端不把日志写入 SQLite,也不依赖 Redis、Kafka 等外部队列。
GET /v1/admin/console 返回:
pending:仍未兑换且未过期的 PIN。code只在服务端能用实例密钥解密时返回;configSummary和config是只读展示数据,codeRef是不可逆诊断引用。sessions:非stopped的会话,包含状态、配置摘要、完整只读配置、configRevision、appliedConfigRevision、applyState、policy、客户端能力、clientState、PinNodelastSeenAt、绑定时间和当前 Tailscale 节点快照。health会区分Healthy、Warning、Offline、Unknown、Ending和Cleaning,其中客户端失联与 Tailscale 节点离线不是同一含义。history:已完成的stopped会话,只保留安全的历史快照,供复制策略和确认清理结果使用;不会返回 session token、auth key 或 credential secret。counts、serverTime和当前全局eventSequence。counts包含pending、sessions、healthy、warning、offline、unknown、ending、cleaning和attention;attention等于活动会话中所有非Healthy状态。
GET /v1/admin/console/stream 和 GET /v1/admin/logs/stream 是同源管理员 SSE。事件带全局递增 id,浏览器会用 Last-Event-ID 续传,也接受 after 查询参数。状态事件和日志事件分别保留在服务端各自最多 2048 项的进程内环形缓冲中,不会互相挤出;日志缓冲仅存在于当前进程。断点早于对应缓冲窗口时发送 reset,客户端应重新读取对应的 Console 或 recent logs 接口。管理员 session 在连接建立后失效时,服务端发送 auth-expired 并关闭连接。日志流事件格式为:
{
"sequence": 42,
"timestamp": "2026-08-29T08:00:00Z",
"level": "WARN",
"source": "client",
"component": "RescueSessionManager",
"message": "PinNode 会话同步失败: IOException",
"sessionId": "…",
"nodeId": "…"
}管理员页面在暂停时停止渲染但继续接收有界事件,显示待处理数量;恢复或点击新日志提示后再渲染。自动滚动只在用户已经位于底部时生效。
PATCH /v1/sessions/{sessionId}/config 虽然沿用 /v1/sessions 资源路径,但只接受管理员 Cookie、X-CSRF-Token 和 same-origin 写请求;session bearer 不能调用它。请求体必须包含页面读取到的 expectedRevision 和部分 config patch:
{
"expectedRevision": 3,
"config": {
"vpnEnabled": true,
"autoGatewayRoute": false,
"advertiseRoutes": ["192.168.50.0/24"],
"exitPolicy": {"onAppClose": true, "afterLoginSeconds": 3600}
},
"confirmHighRisk": false
}服务端先严格拒绝未知字段、重复字段、错误类型和 null,再将 patch 与当前完整配置合并,执行 Normalize 和 CompileSessionPolicy。布尔值的 false、空字符串和空数组都是显式清空语义;未提交字段保持原值,advertiseRoutes 出现时整体替换。数据库只保存规范化后的完整配置和编译后的 routes/wifiRoutes。
provisioning 会话只更新服务端期望配置,设备 attach 响应会返回最新快照;active 会话在提交前检查已保存的客户端能力,若有效路由变化则先用精确 DeviceID 更新 Tailscale 控制面。控制面更新失败不会提交新的 revision。活动会话的 tailscaleIp 只能保持当前值;修改或清空返回 active_tailscale_ip_change_unsupported。
响应包含 configRevision、appliedConfigRevision、完整 config、有效路由、expiresAt、policy 和 applyState。成功写入服务端不代表 Android 已经应用:
pending_client_attach:配置已写入,但 provisioning 会话还未绑定客户端。pending_client_sync:活动客户端尚未在下一次既有 sync 中确认新 revision。synced:服务端configRevision == appliedConfigRevision。route_reconcile_pending:服务端正在恢复一次控制面路由更新的安全边界;此时编辑按钮会暂时禁用。
管理员修改使用 expectedRevision 做 CAS。旧页面保存返回 409 config_revision_conflict,响应带当前安全快照;前端应刷新服务端值但保留未保存草稿。高风险策略需要 confirmHighRisk=true,否则返回 422 high_risk_confirmation_required;活动客户端缺少目标 policy 能力时返回 422 client_capability_missing。已过期、cleaning、cleanup_failed 或 stopped 会话不能借配置修改复活。
POST /v1/sessions/{sessionId}/stop 无请求体。服务端先向 Tailscale 发送 {"routes":[]},再删除精确节点并撤销尚存的 auth key。清理完成为 {"status":"stopped"};已经停止时为 {"status":"already-stopped"}。如果另一个清理 worker 仍持有有效租约,服务端返回 202 和 {"status":"cleaning"},客户端必须保留 pending cleanup,不能把它当成完成。清理失败进入 cleanup_failed,reaper 会继续重试。
管理员使用 POST /v1/admin/sessions/{sessionId}/stop,认证边界为 Admin Cookie + CSRF + same-origin,服务端固定记录 admin_stop 并复用同一套清理 lease、精确路由撤销、设备删除和 auth key 撤销流程。重复请求返回 already-stopped,不会创建第二个清理任务。Tailscale 阶段失败时 API 返回 502 session_cleanup_failed,Console 保留 cleanup_failed 和安全错误摘要,管理员可以再次点击“重试清理”。
| 类别 | 错误码 |
|---|---|
| 通用协议 | route_not_found, method_not_allowed, content_type_invalid, json_invalid, rate_limited, limit_invalid |
| 管理认证 | pow_unavailable, pow_invalid, auth_state_failed, admin_setup_forbidden, admin_username_invalid, admin_password_invalid, admin_already_initialized, admin_setup_failed, admin_session_create_failed, admin_credentials_invalid, admin_login_limited, admin_login_failed, admin_auth_required, admin_auth_failed, csrf_invalid, origin_invalid, secure_transport_required |
| Tailscale 凭据 | credential_required, credential_unavailable, credential_name_invalid, credential_type_unsupported, credential_list_failed, credential_save_failed, api_token_invalid, oauth_client_invalid, oauth_scope_invalid, credential_name_conflict, tailscale_permission_denied, tailscale_rate_limited, tailscale_unavailable |
| pairing code | pairing_code_format_invalid, pairing_code_invalid, pairing_code_read_failed, pairing_code_create_failed |
| 管理监控 | console_read_failed, stream_unsupported |
| 会话创建 | idempotency_key_invalid, idempotency_key_conflict, session_config_invalid, session_config_expired, wifi_gateway_required, wifi_subnet_required, gateway_route_invalid, wifi_subnet_route_invalid, client_capability_missing, session_create_failed, session_replay_failed |
| 会话运行 | session_list_failed, session_path_not_found, session_operation_not_found, session_read_failed, session_not_found, session_auth_required, session_auth_invalid, session_state_conflict, session_expired, protocol_version_unsupported, config_revision_invalid, config_patch_invalid, config_revision_conflict, active_tailscale_ip_change_unsupported, session_route_context_missing, session_config_update_failed, tailscale_route_update_failed, high_risk_confirmation_required, client_metadata_invalid, client_capability_missing, client_state_invalid, client_logs_invalid, node_id_invalid, device_not_ready, device_identity_mismatch, device_not_managed, device_already_bound, device_attach_failed, device_binding_refresh_failed, session_sync_failed, session_cleanup_start_failed, session_cleanup_failed |
每个操作的成功状态和请求/响应结构以 OpenAPI 文件为准;错误状态使用本节的稳定错误码和统一错误信封。
| 方法 | 路径 | 用途 |
|---|---|---|
POST |
/api/v2/oauth/token |
用 client credentials、显式 scope 和 tag 换 access token |
GET |
/api/v2/tailnet/{tailnet}/keys |
无副作用凭据探测 |
POST |
/api/v2/tailnet/{tailnet}/keys |
创建一次性、持久、预授权、带受管 tag 的 auth key |
DELETE |
/api/v2/tailnet/{tailnet}/keys/{keyId} |
撤销 auth key |
GET |
/api/v2/device/{nodeId} |
验证待绑定节点 |
POST |
/api/v2/device/{nodeId}/ip |
设置受管节点的 Tailscale IPv4 |
POST |
/api/v2/device/{nodeId}/routes |
启用精确路由或用空数组撤销路由 |
DELETE |
/api/v2/device/{nodeId} |
删除精确受管节点 |
admin-session-control-v1:管理员可以通过带 CSRF/same-origin 保护的显式 API 远程结束指定会话;该 API 与 Android 的 session bearer stop 分离,但复用相同的清理 lease 和精确资源撤销流程。session-config-update-v1:管理员可以用expectedRevision对 provisioning/active 会话提交受控配置 patch;活动客户端仍只通过现有sync.desiredConfig接收并原子应用新快照。
未知能力必须被忽略;缺少客户端必需能力时,客户端应在创建会话前停止并给出明确的版本错误。