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"
}
]
}
}
Campo | Descripción | Obrigatório |
---|---|---|
data | Objeto | sí |
vehicle_id | String con el ID del vehículo asociado al usuario. Debe ser alfanumérico y tener 15 caracteres de longitud. | sí |
user_id | String con el ID del usuario asociado al vehículo. Debe ser alfanumérico y tener 15 caracteres de longitud. | sí |
Respuestas
Status | Significado | Descripción |
---|---|---|
200 | OK | Respuesta estándar |
400 | Bad Request | Uno 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"
}
]
}
}
Campo | Descripción | Obrigatório |
---|---|---|
data | Objeto | |
type | String con el tipo de permiso, que debe ser igual a 'user_permission'. | sí |
id | String con el ID del permiso. Debe ser alfanumérico y tener 15 caracteres de longitud. | sí |
Respostas
Status | Significado | Descrição |
---|---|---|
200 | OK | Respuesta estándar |
400 | Bad Request | Solicitud inválida |
404 | Not Found | Asociació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âmetro | Descrição |
---|---|
attributes | Especifica qué atributos recuperar. Puede incluir valores como 'serial', 'number', 'carrier', 'service_provider' y 'batch'. Si es nulo, recupera toda la información. |
includes | Especifica 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'. |
filters | Especifica 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'. |
search | Especifica la consulta de búsqueda como mucho 100 caracteres. |
limit | Especifica el número máximo de resultados a devolver. Debe ser un número entre 1 y 100. |
page | Especifica el número de página para resultados paginados. Debe ser un número mayor o igual a 0. |
count | Indica si incluir el total de resultados en la respuesta. |
sort | Especifica los criterios de ordenación para los campos 'number' y 'serial'. Los valores pueden ser -1 (orden descendente) o 1 (orden ascendente). |
Respostas
Status | Significado | Descrição |
---|---|---|
200 | OK | Respuesta estándar |
400 | Bad Request | Solicitud inválida |
Esta operación no requiere autenticación