List Vehicles / Listar Vehiculos

GET

/external/vehiculos

const url = 'https://api-dev.zonaparqueo.com/external/vehiculos?cliente_id=1';
const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api-dev.zonaparqueo.com/external/vehiculos?cliente_id=1' \
  --header 'Authorization: <Authorization>'

Obtiene una lista paginada de vehiculos de un cliente.

Importante: a diferencia de /external/cliente-email, este endpoint si lee los filtros del query string. Enviarlos en el cuerpo JSON hace que el servidor los ignore silenciosamente y devuelva una pagina global sin filtrar. Esto puede provocar que se asocie a un cliente un vehiculo que no le pertenece. Enviar siempre cliente_id (y placa si aplica) como parametros de consulta.

Authorizations

ApiToken

Parameters

Query Parameters

cliente_id

required

integer

Identificador del cliente

placa

string

Filtrar por placa (opcional)

nombre

string

Filtrar por nombre del vehiculo (opcional)

Responses

200

Lista de vehiculos

application/json

object

estado

string

Allowed values: ok

data

Array<object>

object

Identificador del vehiculo

integer

nombre

Nombre o alias del vehiculo

string

placa

Placa del vehiculo

string

cliente_id

Identificador del cliente

integer

activado

Estado de activacion

integer

favorito

Marcado como favorito

integer

total

integer

per_page

integer

current_page

integer

last_page

integer

Examples

success

{
  "estado": "ok",
  "data": [
    {
      "id": 10,
      "nombre": "Mi carro",
      "placa": "ABC123",
      "cliente_id": 5,
      "activado": 1,
      "favorito": 0
    },
    {
      "id": 11,
      "nombre": "Moto",
      "placa": "XYZ789",
      "cliente_id": 5,
      "activado": 1,
      "favorito": 1
    }
  ],
  "total": 2,
  "per_page": 15,
  "current_page": 1,
  "last_page": 1
}

400

Solicitud invalida

application/json

object

estado

string

Allowed values: fail

error

Mensaje de error

string

errores

Detalle de errores por campo

object

Example

{
  "estado": "fail"
}