Docs
Vehículos
Associations Users

Asociaciones de Usuarios

Crear Asociaciones de Usuarios con Vehículos

POST /v2/vehicles/associations/users

Datos de Envío

{
  "body": {
    "data": [
      {
        "vehicle_id": "ABC1234567890DEF",
        "user_id": "GHI9876543210JKL"
      },
      {
        "vehicle_id": "MNO4567890123PQR",
        "user_id": "STU2109876543VWX"
      }
    ]
  }
}
CampoDescripciónObrigatório
dataObjeto
vehicle_idString con el ID del vehículo asociado al usuario. Debe ser alfanumérico y tener 15 caracteres de longitud.
user_idString con el ID del usuario asociado al vehículo. Debe ser alfanumérico y tener 15 caracteres de longitud.

Respuestas

StatusSignificadoDescripción
200OKRespuesta estándar
400Bad RequestUno de 'Bad Request' o 'Vehicle And User Are in Different Enterprises'

Esta operación no requiere autenticación

Eliminar Asociaciones de Usuarios con Vehículos

DELETE /v2/vehicles/associations/users

Datos de Envío

{
  "body": {
    "data": [
      {
        "type": "user_permission",
        "id": "ABC1234567890DEF"
      },
      {
        "type": "user_permission",
        "id": "GHI9876543210JKL"
      }
    ]
  }
}
CampoDescripciónObrigatório
dataObjeto
typeString con el tipo de permiso, que debe ser igual a 'user_permission'.
idString con el ID del permiso. Debe ser alfanumérico y tener 15 caracteres de longitud.

Respostas

StatusSignificadoDescrição
200OKRespuesta estándar
400Bad RequestSolicitud inválida
404Not FoundAsociación no encontrada

Esta operación no requiere autenticación

Listar Associações de Usuários com Veículos

GET /v2/vehicles/{vehicle_id}/associations/users

ParâmetroDescrição
attributesEspecifica qué atributos recuperar. Puede incluir valores como 'serial', 'number', 'carrier', 'service_provider' y 'batch'. Si es nulo, recupera toda la información.
includesEspecifica las entidades relacionadas para incluir en la consulta. Contiene array para 'device' y 'enterprise', cada uno con su propio conjunto de valores posibles, como 'name', 'imei', 'code' para el array 'device', y 'name', 'cnpj' para el array 'enterprise'.
filtersEspecifica filtros para varios campos como 'chips.serial', 'chips.number', 'chips.carrier', 'chips.service_provider', 'chips.batch', 'device.name', 'device.imei', 'device.code', 'enterprise.name', 'enterprise.cnpj'. Cada campo de filtro admite condiciones como 'eq', 'neq', 'ilk', 'ew', 'sw'.
searchEspecifica la consulta de búsqueda como mucho 100 caracteres.
limitEspecifica el número máximo de resultados a devolver. Debe ser un número entre 1 y 100.
pageEspecifica el número de página para resultados paginados. Debe ser un número mayor o igual a 0.
countIndica si incluir el total de resultados en la respuesta.
sortEspecifica los criterios de ordenación para los campos 'number' y 'serial'. Los valores pueden ser -1 (orden descendente) o 1 (orden ascendente).

Respostas

StatusSignificadoDescrição
200OKRespuesta estándar
400Bad RequestSolicitud inválida

Esta operación no requiere autenticación