Flujo de API rastreable

Flujo anónimo respaldado por secretos

Use esta guía cuando quien llama no vaya a iniciar sesión, pero ya tenga la sesión activa del rastreable en este navegador o tenga en sus manos el código secreto corto exacto o el token QR privado del rastreable y necesite dejar una actualización de ubicación o un comentario de inmediato.

Siga la secuencia Flujo autenticado Referencia de error Documentos de API principales

Reglas básicas

El rastreable ya debe estar activado. Los elementos no activados rechazan comentarios y escrituras de parada de viaje.
Cada escritura anónima debe venir de la sesión activa del rastreable en este navegador o incluir la credencial de acceso exacta para ese rastreable especifico.
La credencial de acceso puede ser el código secreto corto, el token QR sin formato o la URL /trackable/{code} completa.
Las publicaciones anónimas son solo de agregado para la persona que las creo. Solo el propietario del rastreable o los administradores actuales del equipo pueden eliminarlas después.
Los propietarios rastreables y los administradores actuales del equipo pueden moderar eliminando un comentario o una parada del viaje, pero no pueden editar el contenido de otra persona.

Paso 1: resolver o visitar el rastreable

Una persona que llama anónima aún puede leer datos rastreables y puntos de viaje seguros para el público antes de publicar.

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

{
  "code": "LN4C8R2Z"
}

Si el código es un secreto corto o un token QR, el navegador obtiene una sesión activa respaldada por ese secreto. Las escrituras de la API pueden usar esa sesión activa, o quien llama puede reenviar el código de acceso cuando haga falta.

Paso 2: Lea el estado actual de seguridad pública

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

La carga de comentarios le indica a un cliente anónimo que publicar est? permitido, si el navegador ya tiene acceso activo y que las publicaciones anónimas solo pueden ser eliminadas después por el propietario del rastreable o los administradores actuales del equipo.

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.

Paso 3: Publique un comentario anónimo

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

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

Si quien llama omite el código por completo y el navegador todavía no lleva una sesión activa para ese mismo rastreable, la API devuelve una respuesta de detalles del problema con estado prohibido y el código: "trackable_access_code_required". Si el código pertenece a otro rastreable o está mal formado para este elemento, la respuesta usa trackable_access_code_invalid.

Paso 4: Publique un informe de mapa directo anónimo

POST https://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>"
}

Este es el flujo ligero de primer mapa. La parada se almacena directamente en el viaje rastreable sin crear una nota. Si la persona inicia sesión más tarde y desea un contenido de notas más completo, el sitio web puede enviarla al flujo de creación de notas desde esa parada.

Mensajería amigable para el cliente

El flujo anónimo funciona mejor cuando el cliente explica la limitación sin parecer amenazador. Un buen patrón es:

Puedes publicar esto sin una cuenta.
Las actualizaciones anónimas no se pueden editar ni eliminar más tarde,
pero el propietario rastreable o los administradores del equipo pueden moderarlos si es necesario.

Si el usuario desea editar o convertir notas en el futuro, ofrezca una acción secundaria como Iniciar sesión para dejar una nota en lugar de forzar el inicio de sesión por adelantado.

Después de publicar

Actualice los puntos finales del recorrido y los comentarios para que el cliente pueda mostrar la parada o el comentario recién publicado de inmediato.

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

Moderación y limpieza

Los comentarios anónimos y las paradas anónimas del recorrido siguen ligados a un rastreable especifico porque cada escritura esta autorizada por la sesión activa o la credencial de acceso de ese rastreable.
Las exportaciones incluyen aquellos registros con indicadores anónimos explícitos/authenticated.
Las exportaciones de rastreables y los flujos de retencion pueden mantener las instantaneas de paradas guardadas y los registros de enlace de notas como hechos separados para que las ediciones posteriores de la nota no reescriban el historial anterior de la ruta.
Si surge un mal actor, los propietarios y administradores actuales del equipo pueden eliminar los registros afectados de forma permanente.

Cuando la persona que llama esté lista para poseer o editar lo que pública, muévala al flujo rastreable autenticado. Para respuestas negativas, utilice referencia de error rastreable.