数据类型与时间#

字段表以实际 JSON 语义为准，不能直接照搬 Java 或 TypeScript 类型。字段级 JSON 类型、必填与可空、默认值、枚举与单位以清单层与 Swagger 的端点级 schema 为唯一权威源（data-service 端点清单、device-service 端点清单）；本页只约定跨端点的公共序列化规则，未知项保持未知。

公共序列化规则如下：

值	当前 JSON 规则
timestamp	epoch 毫秒
LocalDate、LocalTime、LocalDateTime	UTC 秒数；反序列化数值小于 1 时为 null
BigDecimal	字符串

资源 ID、设备号与租户投影不是同一概念。同一物理设备可在不同租户存在同号投影；各标识的用途以清单层相应资源的事实为准，不假定所有 ID 都是数值或 UUID。

依据#

适用后端基线：源码归纳 @ 2026-09-14。响应信封 timestamp 字段、时间与 BigDecimal 的序列化格式、空间标识语义均为源码归纳结论。字段级 JSON 类型仍须以各操作的清单层 schema 核验。