可追踪的 API 错误

可追踪错误参考

可跟踪的问题详细信息响应包括稳定的机器可读代码值。当客户或开发人员需要决定下一步做什么而无需根据自由格式的英文文本进行猜测时，请使用此页面。

问题细节形状

{
  "title": "Forbidden",
  "code": "trackable_access_code_required",
  "detail": "Sign in, keep this trackable active on this browser, or provide this trackable's secret code or QR access code before posting comments or location reports.",
  "status": 403
}

并非每个与可跟踪相关的故障都是问题详细信息有效负载。代码查找未命中仍会返回带有 { "found": false } 的普通成功负载，因此调用者可以保持查找 UI 简单。

错误代码

代码	状态	典型路线	含义	客户指导
`trackable_not_found`	404	激活、分组管理、删除路由	目标可跟踪不存在或无法在该操作中解析。	刷新列表，重新运行查找，或确认 GUID。
`trackable_comment_not_found`	404	评论更新或删除	该可跟踪的目标可跟踪评论不再存在。	刷新评论并删除陈旧的 UI 条目。
`trackable_journey_stop_not_found`	404	旅程停止删除	所请求的旅程停靠站不再存在于该可追踪设备上。	刷新旅程并放弃陈旧的动作可供性。
`trackable_already_activated`	400	`POST /api/trackables/{trackableId}/activate`	调用者尝试激活已具有所有者范围的可跟踪对象。	加载当前详细信息页面而不是重复激活。
`trackable_activation_required`	400	匿名或登录评论/journey-stop写道	该项目仍处于未激活状态，因此尚无法接受新评论或路由活动。	提示符合条件的登录所有者首先激活可追踪。
`trackable_access_code_required`	403	匿名评论和旅程停止写道	调用者未登录，也没有活动的浏览器会话或该可跟踪的另一个有效的秘密支持的访问凭据。	要求提供准确的短密码或 QR 令牌，使可跟踪在此浏览器上保持活动状态，或提供登录。
`trackable_access_code_invalid`	403	匿名评论和旅程停止写道	提供的访问凭据无法解析为该特定的可跟踪对象。	告诉呼叫者该代码属于其他项目或输入错误。
`trackable_group_detach_forbidden`	403	`DELETE /api/trackables/{trackableId}/group`	调用者不是原始激活者，也不是当前组上下文的合格组管理员。	使用当前控制该分组项目的用户。
`trackable_group_attach_forbidden`	403	`POST /api/trackables/{trackableId}/group`	不允许调用者将该分离的可跟踪对象与不同的组关联。	返回到原始激活器或允许的控制上下文。
`trackable_comment_edit_forbidden`	403	`PUT /api/trackables/{trackableId}/comments/{commentId}`	只有经过身份验证的评论的登录作者才能对其进行编辑。	为其他人隐藏编辑控件。
`trackable_comment_delete_forbidden`	403	评论删除	调用者既不是登录的评论作者，也不是具有审核权的所有者/team管理员。	将删除保留为仅管理操作。
`trackable_journey_stop_delete_forbidden`	403	旅程停止删除	调用者既不是该站点的经过身份验证的作者，也不是所有者/team管理员。	仅当当前用户实际上可以控制删除时才显示停止删除。
`trackable_journey_stop_convert_forbidden`	403	网站转化流程	只有创建经过身份验证的直接报告的登录人员才能将其转换为注释。	不显示匿名或第三方创作的停靠点的转化操作。
`trackable_journey_stop_convert_rejected`	400	网站转化流程	停靠点存在，但请求的注释转换对于该停靠点或注释组合无效。	请用户从所选位置创建新注释。
`trackable_request_rejected`	400或403	回退	可跟踪规则拒绝了该请求，但没有分配更多特定的机器代码。	将人类可读的详细文本和路线上下文一起使用。

地点、历史和访问保持独立：旅程停靠点保留捕捉的坐标，注释保留其自己的可编辑记录，注释的可见性加上所需的访问范围决定谁可以打开注释内容。

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

查找未命中不是问题细节

{
  "found": false,
  "error": "Code not found."
}

查找 API 故意在此处使用成功有效负载，因为预计会出现输入错误，并且 UI 通常希望保持查找模式而不是切换到错误处理模式。

当代码明显属于另一个实时系统或应该使用自带流程时，查找负载还可以包含指向原始站点或单可跟踪创建页面的帮助链接。