Cargando ...

POST /api/devices/{deviceId}/alerts

Este endpoint permite enviar datos de alertas para un dispositivo específico en la aplicación de seguimiento satelital. Es útil para actualizar el sistema con nueva información de alertas del dispositivo.

Detalles de la Solicitud

La solicitud se realiza utilizando el método POST en la URL /api/devices/{deviceId}/alerts. Debes reemplazar {deviceId} con el ID real del dispositivo que deseas actualizar.

Parámetros de la Solicitud

Este endpoint requiere el parámetro deviceId que debe incluirse en la ruta de la URL.

Parámetro Tipo Obligatorio Descripción
deviceId string El identificador único del dispositivo a actualizar.

Parámetros del Cuerpo de la Solicitud

El cuerpo de la solicitud debe incluir un objeto JSON con los datos de la alerta para el dispositivo.

Campo Tipo Obligatorio Descripción
from string Fecha y hora de inicio de la alerta, en formato ISO 8601.
to string Fecha y hora de fin de la alerta, en formato ISO 8601.
alertName string No Nombre de la alerta.

Autenticación Requerida

La autenticación requerida para utilizar el endpoint es mediante un token Bearer. Este método de autenticación implica que cada solicitud debe incluir un encabezado de autorización con un token de acceso válido. Este token Bearer actúa como una credencial que verifica la identidad del usuario o aplicación que realiza la solicitud, asegurando que solo las entidades autorizadas puedan modificar la información del usuario. Al requerir este tipo de autenticación, el sistema Secure GPS garantiza un nivel elevado de seguridad y control de acceso, protegiendo los datos de los usuarios contra accesos no autorizados.

Ejemplo de Solicitud

POST /api/devices/device123/alerts HTTP/1.1 Host: api.plaspy.com Authorization: Bearer {token} Content-Type: application/json { "from": "2024-06-01T00:00:00Z", "to": "2024-06-01T23:59:59Z", "alertName": "Speeding Alert" }

Parámetros de Respuesta

La respuesta de este endpoint incluye detalles sobre el éxito de la operación y cualquier error que pueda haber ocurrido.

Campo Tipo Obligatorio Descripción
success boolean Indica si la solicitud fue exitosa.
error string No Mensaje de error en caso de que la solicitud falle.
apiUsage integer No Uso de la API en la solicitud actual.
apiDailyUsage integer No Uso diario de la API.
alerts array No Lista de objetos de alerta si la solicitud fue exitosa. Cada objeto contiene información detallada sobre la alerta.

Dentro del campo alerts, el objeto tiene los siguientes campos:

Campo Tipo Obligatorio Descripción
dateTime string Fecha y hora de la alerta.
latitude number Latitud de la alerta.
longitude number Longitud de la alerta.
text string No Texto descriptivo de la alerta.
notifications array No Lista de notificaciones.
alerts array No Lista de alertas asociadas.

Ejemplo de Respuesta Exitosa

{ "success": true, "apiUsage": 150, "apiDailyUsage": 3000, "alerts": [ { "dateTime": "2024-06-01T12:00:00Z", "latitude": 40.712776, "longitude": -74.005974, "text": "Speeding Alert", "notifications": ["Email", "SMS"], "alerts": ["High Speed"] } ] }

Ejemplo de Respuesta de Error

Respuesta de Error 400 (Bad Request)

{ "success": false, "error": "Bad Request", "apiUsage": 150, "apiDailyUsage": 3000 }

Respuesta de Error 500 (Internal Server Error)

{ "success": false, "error": "Internal Server Error", "apiUsage": 150, "apiDailyUsage": 3000 }

Este endpoint es esencial para actualizar los datos de alertas de un dispositivo dentro del sistema Secure GPS. Permite a los usuarios enviar información de alertas detallada y actualizada para un dispositivo específico, asegurando un seguimiento y monitoreo precisos.

Índice
Última modificación: 2024-06-05 19:59:36