可追踪的API流量

匿名秘密支持流

当呼叫者不会登录但具有此浏览器的活动可跟踪会话或实际持有可跟踪的确切短密码或私有 QR 令牌并且需要立即留下位置更新或评论时，请使用本指南。

核心规则

可追踪必须已激活。未激活的项目拒绝评论和旅程停止写入。
每个匿名写入都必须来自该浏览器的活动可跟踪会话，或者包含该特定可跟踪的确切访问凭据。
访问凭证可以是短密码、原始 QR 令牌或完整的 /trackable/{code} URL。
匿名帖子仅供创建者添加。只有可跟踪的所有者或当前团队管理员才能稍后删除它们。
可追踪的所有者和当前团队管理员可以通过删除评论或旅程停止来进行调节，但他们无法编辑其他人的内容。

第 1 步：解决或访问可追踪的

匿名呼叫者仍然可以在发布之前读取公共安全的可跟踪数据和旅程点。

POST https://www.locationnotes.com/api/trackables/lookup
Content-Type: application/json

{
  "code": "LN4C8R2Z"
}

如果代码是短秘密或 QR 令牌，则浏览器将获得活动的秘密支持会话。 API 写入可以使用该活动会话，或者调用者可以在需要时重新发送访问代码。

第 2 步：了解当前的公共安全状态

GET https://www.locationnotes.com/api/trackables/{trackableId}
GET https://www.locationnotes.com/api/trackables/{trackableId}/journey
GET https://www.locationnotes.com/api/trackables/{trackableId}/comments

评论有效负载告诉匿名客户端允许发帖，浏览器是否已经具有活动访问权限，并且匿名帖子只能由可跟踪的所有者或当前团队管理员稍后删除。

旅程读取显示已保存的停靠站加上 currentNotesAtCoordinate。该集合是当今同一坐标的可见纸币读取模型，而不是该站点永久拥有一张纸币的证明。

第 3 步：发表匿名评论

POST https://www.locationnotes.com/api/trackables/{trackableId}/comments
Content-Type: application/json

{
  "body": "Saw it at the reception desk.",
  "accessCode": "LN4C8R2Z"
}

如果调用者完全省略代码并且浏览器尚未承载同一可跟踪的活动会话，则 API 将返回禁止的问题详细信息响应，代码为：“trackable_access_code_required”。如果代码属于另一个可跟踪的代码或者对于该项目来说格式不正确，则响应使用 trackable_access_code_invalid。

第 4 步：发布匿名直接地图报告

POST https://www.locationnotes.com/api/trackables/{trackableId}/journey-stops
Content-Type: application/json

{
  "latitude": 41.881832,
  "longitude": -87.623177,
  "accessCode": "https://locationnotes.com/trackable/ABCD...<raw or full URL>"
}

这是轻量级的地图优先流程。停靠点直接存储在可追踪的旅程中，无需创建注释。如果用户稍后登录并想要更丰富的笔记内容，网站可以将他们从该站点发送到笔记创建流程。

友好的客户消息传递

当客户解释限制且听起来不带有威胁性时，匿名流程效果最佳。一个好的模式是：

您无需帐户即可发布此内容。
匿名更新以后无法编辑或删除，
但如果需要，可追踪的所有者或团队管理员可以对其进行审核。

如果用户确实希望将来进行编辑或注释转换，请提供辅助操作（例如“登录”以留下注释），而不是强制预先登录。

发帖后

刷新旅程和评论端点，以便客户端可以立即显示新发布的站点或评论。

GET https://www.locationnotes.com/api/trackables/{trackableId}/journey
GET https://www.locationnotes.com/api/trackables/{trackableId}/comments

审核和清理

匿名评论和匿名旅程停靠点仍然与特定的可跟踪项相关联，因为每次写入都由该可跟踪项的活动会话或访问凭证授权。
导出包括带有显式匿名/authenticated标志的记录。
可跟踪的导出和保留流可以将保存的停止快照和注释链接记录保留为单独的事实，以便以后的注释编辑不会重写早期的路线历史记录。
如果出现不良行为者，所有者和当前团队管理员可以永久删除受影响的记录。