平台

Orinverse API（草案）

Orinverse 是基于坐标的数据层，本节概述创建与读取地图点的最小 API。

本节为设计草案，URL、认证方式与响应格式在实现前需确认。

点数据模型

字段	类型	说明
`id`	string	点的唯一标识。
`lat`	number	纬度（必填）。
`lon`	number	经度（必填）。
`title`	string	简短标题。
`payload`	object	自定义数据（消息、元数据、链接）。
`tags`	string[]	用于过滤与分组的标签。
`anchorTx`	string	可选的 ORIN 交易锚定。
`createdAt`	string	创建时间 ISO 时间戳。
`updatedAt`	string	更新时间 ISO 时间戳。

创建点

POST /api/v1/points

{
  "lat": 55.751244,
  "lon": 37.618423,
  "title": "示例点",
  "payload": {
    "text": "Orinverse 示例内容",
    "link": "https://orinverse.cash"
  },
  "tags": ["info", "community"]
}

响应应返回新的 id 与可选的 anchorTx。

读取与搜索

GET /api/v1/points/{id} — 获取单个点。
GET /api/v1/points?bbox=lat1,lon1,lat2,lon2 — 按边界框搜索。
GET /api/v1/points?tags=community,news — 按标签过滤。

更新与删除

PATCH /api/v1/points/{id} — 局部更新。
DELETE /api/v1/points/{id} — 删除或下架。

ORIN 锚定

发布点数据时可将 payload 哈希锚定到 ORIN。 Orinverse 应在可用时返回 anchorTx 与确认信息。