Posición del Dispositivo por Nombre

URL: /DataConnectAPI/api/Device/{plate}

Descripción: Recupera la posición actual y la información adicional de un dispositivo usando su identificador de placa.

Método: GET

Parámetros:

• plate (cadena, requerido): El identificador de la placa del dispositivo.

Encabezados:

• Authorization (requerido): Bearer <token>
• Client-ID (requerido): <Código del cliente>

Ejemplo de Solicitud:

GET /DataConnectAPI/api/Device/ABC123
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR...
Client-ID: 12345

Ejemplo de Respuesta:

{
  "id": 1,
  "serial": "SN123456",
  "plate": "ABC123",
  "latitude": 34.052235,
  "longitude": -118.243683,
  "altitude": 89.0,
  "deviceDateTime": "2024-10-21T14:55:00Z",
  "speed": 50.5,
  "course": 90.0,
  "address": "123 Main St, Los Angeles, CA",
  "distanceToAddress": 0.3,
  "city": "Los Angeles",
  "state": "CA",
  "country": "USA",
  "ignition": true,
  "satellites": 12,
  "mileage": 12000.5,
  "hobbsMeter": 500.2,
  "temperature": 25.4
}

Posición del Dispositivo por ID

URL: /DataConnectAPI/api/Device?id={id}

Descripción: Recupera la posición actual y la información adicional de un dispositivo usando su ID único.

Método: GET

Parámetros:

• id (int, requerido): El ID único del dispositivo.

Encabezados:

• Authorization (requerido): Bearer <token>
• Client-ID (requerido): <Código del cliente>

Ejemplo de Respuesta:

{
  "id": 1,
  "serial": "SN123456",
  "plate": "ABC123",
  "latitude": 34.052235,
  "longitude": -118.243683,
  "altitude": 89.0,
  "deviceDateTime": "2024-10-21T14:55:00Z",
  "speed": 50.5,
  "course": 90.0,
  "address": "123 Main St, Los Angeles, CA",
  "distanceToAddress": 0.3,
  "city": "Los Angeles",
  "state": "CA",
  "country": "USA",
  "ignition": true,
  "satellites": 12,
  "mileage": 12000.5,
  "hobbsMeter": 500.2,
  "temperature": 25.4
}

Posición de Múltiples Dispositivos

URL: /DataConnectAPI/api/Devices?id=1&id=2&id=3,...

Descripción: Recupera las posiciones actuales y detalles adicionales de múltiples dispositivos por sus IDs.

Método: GET

Parámetros:

• IDs (arreglo de enteros, requerido): Lista de IDs de dispositivos (ejemplo: ?id=1&id=2&id=3).

Encabezados:

• Authorization (requerido): Bearer <token>
• Client-ID (requerido): <Código del cliente>

Ejemplo de Respuesta:

[
  {
    "id": 1,
    "serial": "SN123456",
    "plate": "ABC123",
    "latitude": 34.052235,
    "longitude": -118.243683,
    "altitude": 89.0,
    "deviceDateTime": "2024-10-21T14:55:00Z",
    "speed": 50.5,
    "course": 90.0,
    "address": "123 Main St, Los Angeles, CA",
    "distanceToAddress": 0.3,
    "city": "Los Angeles",
    "state": "CA",
    "country": "USA",
    "ignition": true,
    "satellites": 12,
    "mileage": 12000.5,
    "hobbsMeter": 500.2,
    "temperature": 25.4
  },
  ...
]

Posición de Todos los Dispositivos

URL: /DataConnectAPI/api/AllDevices

Descripción: Recupera las posiciones actuales y detalles adicionales de todos los dispositivos.

Método: GET

Encabezados:

• Authorization (requerido): Bearer <token>
• Client-ID (requerido): <Código del cliente>

Ejemplo de Respuesta:

[
  {
    "id": 1,
    "serial": "SN123456",
    "plate": "ABC123",
    "latitude": 34.052235,
    "longitude": -118.243683,
    "altitude": 89.0,
    "deviceDateTime": "2024-10-21T14:55:00Z",
    "speed": 50.5,
    "course": 90.0,
    "address": "123 Main St, Los Angeles, CA",
    "distanceToAddress": 0.3,
    "city": "Los Angeles",
    "state": "CA",
    "country": "USA",
    "ignition": true,
    "satellites": 12,
    "mileage": 12000.5,
    "hobbsMeter": 500.2,
    "temperature": 25.4
  },
  ...
]

Historial de Posición del Dispositivo

URL: /DataConnectAPI/api/Position/{plate}/{from}/{to}

Descripción: Recupera las posiciones históricas de un dispositivo dentro de un rango de tiempo especificado.

Método: GET

Parámetros:

• plate (cadena, requerido): El identificador de la placa del dispositivo.
• from (fecha y hora ISO 8601, requerido): Fecha y hora de inicio.
• to (fecha y hora ISO 8601, requerido): Fecha y hora de fin.

Encabezados:

• Authorization (requerido): Bearer <token>
• Client-ID (requerido): <Código del cliente>

Ejemplo de Respuesta:

[
  {
    "positionId": 1001,
    "serial": "SN123456",
    "plate": "ABC123",
    "latitude": 34.052235,
    "longitude": -118.243683,
    "altitude": 89.0,
    "deviceDateTime": "2024-01-01T00:15:00Z",
    "serverDateTime": "2024-01-01T00:15:02Z",
    "speed": 48.0,
    "course": 90.0,
    "eventId": 2001,
    "address": "123 Main St, Los Angeles, CA",
    "distanceToAddress": 0.3,
    "city": "Los Angeles",
    "state": "CA",
    "country": "USA",
    "ignition": true,
    "satellites": 10,
    "mileage": 12005.5,
    "temperature": 22.5
  },
  ...
]

Autenticación

URL: /SecurityApi/auth/authenticate

Descripción: Recupera un token de autenticación.

Método: POST

Parámetros:

• Username (cadena, requerido): El nombre de usuario.
• Password (cadena, requerido): La contraseña.
• UniqueId (guid, requerido): Autogenerado.

Ejemplo de Solicitud:

POST /SecurityApi/Auth/authenticate
Content-Type: application/json

{
  "Username": "user123",
  "Password": "pass123",
  "UniqueId": "unique-client-id"
}

Ejemplo de Respuesta:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Soporte

Si encuentras algún problema o necesitas ayuda adicional, por favor, contáctanos a via correo electrónico:

• Correo electrónico: soporte@c2ls.co