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 anonima debe venir de la sesion activa del trackable en este navegador o incluir la credencial de acceso exacta para ese trackable 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 anonimas son solo de agregado para la persona que las creo. Solo el propietario del trackable o los administradores actuales del equipo pueden eliminarlas despues.
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://www.locationnotes.com/api/trackables/lookup
Content-Type: application/json

{
  "code": "LN4C8R2Z"
}

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

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

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

La carga de comentarios le indica a un cliente anonimo que publicar esta permitido, si el navegador ya tiene acceso activo y que las publicaciones anonimas solo pueden ser eliminadas despues por el propietario del trackable 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://www.locationnotes.com/api/trackables/{trackableId}/comments
Content-Type: application/json

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

Si quien llama omite el codigo por completo y el navegador todavia no lleva una sesion activa para ese mismo trackable, la API devuelve una respuesta de detalles del problema con estado prohibido y el codigo: "trackable_access_code_required". Si el codigo pertenece a otro trackable o esta mal formado para este elemento, la respuesta usa trackable_access_code_invalid.

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

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>"
}

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://www.locationnotes.com/api/trackables/{trackableId}/journey
GET https://www.locationnotes.com/api/trackables/{trackableId}/comments

Moderación y limpieza

Los comentarios anonimos y las paradas anonimas del recorrido siguen ligados a un trackable especifico porque cada escritura esta autorizada por la sesion activa o la credencial de acceso de ese trackable.
Las exportaciones incluyen aquellos registros con indicadores anónimos explícitos/authenticated.
Las exportaciones de trackables 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 publica, muévala al flujo rastreable autenticado. Para respuestas negativas, utilice referencia de error rastreable.