Forma de detalles del problema
{
"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
}No todas las fallas relacionadas con el seguimiento son una carga útil de detalles del problema. Los errores de búsqueda de código aún devuelven una carga útil de éxito normal con { "found": false } para que la persona que llama pueda mantener la interfaz de usuario de búsqueda simple.
Códigos de error
| Código | Estado | Ruta típica | Significado | Guía para el cliente |
|---|---|---|---|---|
trackable_not_found |
404 | Activar, administrar grupos, eliminar rutas | El objetivo rastreable no existe o no se puede resolver en esa operación. | Actualice la lista, vuelva a ejecutar la búsqueda o confirme el GUID. |
trackable_comment_not_found |
404 | Actualizar o eliminar comentarios | El comentario rastreable de destino ya no existe en ese rastreable. | Actualizar comentarios y eliminar la entrada obsoleta de la interfaz de usuario. |
trackable_journey_stop_not_found |
404 | Eliminación de parada del viaje | La parada de viaje solicitada ya no existe en ese rastreable. | Actualice el viaje y elimine la posibilidad de acción obsoleta. |
trackable_already_activated |
400 | POST /api/trackables/{trackableId}/activate |
La persona que llama intentó activar un rastreable que ya tiene un alcance de propietario. | Cargue la página de detalles actual en lugar de repetir la activación. |
trackable_activation_required |
400 | Comentarios o paradas del recorrido, anonimos o con sesion iniciada | dedicado. El elemento aún está desactivado, por lo que aún no puede aceptar nuevos comentarios ni actividad de ruta. | Solicite a un propietario elegible que haya iniciado sesión que active primero el rastreable. |
trackable_access_code_required |
403 | Comentarios anónimos y escrituras de paradas de viaje | Quien llama no ha iniciado sesion y tampoco tiene una sesion activa del navegador ni otra credencial valida de acceso respaldada por secreto para ese trackable. | Pida el codigo secreto corto exacto o el token QR, mantenga el trackable activo en este navegador u ofrezca iniciar sesion. |
trackable_access_code_invalid |
403 | Comentarios anónimos y escrituras de paradas de viaje | La credencial de acceso proporcionada no se resuelve en este rastreable específico. | Dígale a la persona que llama que el código pertenece a otro artículo o que se ingresó incorrectamente. |
trackable_group_detach_forbidden |
403 | DELETE /api/trackables/{trackableId}/group |
La persona que llama no es el activador original ni un administrador de grupo elegible para el contexto del grupo actual. | Utilice un usuario que actualmente controle ese elemento agrupado. |
trackable_group_attach_forbidden |
403 | POST /api/trackables/{trackableId}/group |
La persona que llama no puede asociar ese rastreable separado con un grupo diferente. | Regrese al activador original o a un contexto de control permitido. |
trackable_comment_edit_forbidden |
403 | PUT /api/trackables/{trackableId}/comments/{commentId} |
Solo el autor que haya iniciado sesión en un comentario autenticado puede editarlo. | Oculta los controles de edición para todos los demás. |
trackable_comment_delete_forbidden |
403 | Eliminar comentario | La persona que llama no es el autor del comentario que inició sesión ni un propietario/team administrador con poder de moderación. | Mantener la eliminación como una acción solo de administración. |
trackable_journey_stop_delete_forbidden |
403 | Eliminación de parada del viaje | La persona que llama no es el autor autenticado de esa parada ni un administrador propietario/team. | Solo muestra detener la eliminación cuando el usuario actual realmente pueda moderarla. |
trackable_journey_stop_convert_forbidden |
403 | Flujo de conversión del sitio web | Solo la persona que inició sesión y creó un subordinado directo autenticado puede convertirlo en una nota. | No mostrar acciones de conversión para detenciones anónimas o realizadas por terceros. |
trackable_journey_stop_convert_rejected |
400 | Flujo de conversión del sitio web | La parada existe, pero la conversión de nota solicitada no es válida para esa parada o combinación de notas. | Pídale al usuario que cree una nueva nota desde la ubicación seleccionada. |
trackable_request_rejected |
400 o 403 | Alternativa | Una regla rastreable rechazó la solicitud, pero no se asignó ningún código de máquina más específico. | Utilice el texto detallado legible por humanos y el contexto de ruta juntos. |
Lugar, historial y acceso se mantienen separados: la parada del recorrido conserva la coordenada capturada, la nota mantiene su propio registro editable y la visibilidad de la nota junto con su alcance de acceso requerido deciden quien puede abrir el contenido de la nota.
Las lecturas del recorrido exponen la parada guardada junto con currentNotesAtCoordinate. Esa coleccion es el modelo de lectura de notas visibles de hoy para la misma coordenada, no una prueba de que la parada sea propietaria permanente de una sola nota.
Los errores de búsqueda no son problemas: detalles
{
"found": false,
"error": "Code not found."
}La API de búsqueda utiliza intencionalmente una carga útil aquí porque se esperan errores tipográficos y la interfaz de usuario generalmente desea permanecer en modo de búsqueda en lugar de cambiar al manejo de errores.
Cuando el codigo claramente pertenece a otro sistema activo o deberia usar el flujo de codigo propio, la respuesta de busqueda tambien puede incluir un enlace de ayuda que apunte al sitio de origen o a la pagina de crear un solo trackable.