Primeros pasos

La API pública cubre actualmente Alquiler. Tu software puede sincronizar vehículos y expedientes de alquiler, iniciar inspecciones y recuperar resultados validados. La referencia API define exactamente cada petición y respuesta.

1. Crear una clave

Un administrador abre API & integrations en la aplicación TrakarIA y crea una clave API. El acceso depende del plan de Alquiler de la organización. Usa una clave por integración: el secreto completo solo se muestra una vez. Consulta autenticación y acceso.

La URL base es https://api.trakaria.com. Las peticiones hechas con tu clave modifican los datos reales de tu cuenta.

2. Comprobar el acceso y los límites

Pon la clave en tu terminal sin guardarla en el código fuente y realiza una petición de solo lectura:

export TRAKARIA_API_KEY='your-api-key'
curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer ${TRAKARIA_API_KEY}" \
  https://api.trakaria.com/v1/capabilities

La respuesta indica las funciones de Alquiler y los límites aplicables a tu organización. Un 401 puede indicar una clave inválida o caducada; un 403, permisos o un plan insuficientes. Consulta sincronización y errores.

3. Sincronizar un vehículo y un expediente de alquiler

Para una prueba, utiliza identificadores externos distintos y fáciles de encontrar, sin datos personales reales. Las siguientes peticiones crean registros en tu cuenta. Sustituye los valores de ejemplo; reutiliza el mismo identificador externo para actualizar el mismo recurso. Conserva los id públicos devueltos para las peticiones posteriores.

curl --fail-with-body --silent --show-error \
  -X PUT 'https://api.trakaria.com/v1/vehicles/by-external/demo-vehicle-001' \
  -H "Authorization: Bearer ${TRAKARIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{"plate":"AA-123-AA","name":"Vehículo agencia aeropuerto","photo_url":"https://cdn.example.com/fleet/demo-vehicle-001.jpg","make":"Example","model":"Car","trim":"Business","year":2025,"registration_date":"2025-03-20","vehicle_type":"hatchback","energy":"petrol","gearbox":"automatic","transmission":"fwd","color":"Azul","mileage":12000,"source_revision":1}'

curl --fail-with-body --silent --show-error \
  -X PUT 'https://api.trakaria.com/v1/rentals/by-external/demo-reservation-001' \
  -H "Authorization: Bearer ${TRAKARIA_API_KEY}" \
  -H 'Content-Type: application/json' \
  -d '{"vehicle_external_id":"demo-vehicle-001","source_revision":1}'

La segunda petición crea inmediatamente una entrada visible en el planning. La respuesta contiene el id del expediente y planning.entry_id. Solo vehicle_external_id es obligatorio en el cuerpo: fechas previstas, referencias, ubicaciones, contacto y conductores son opcionales. Puedes enviarlos con antelación, durante la entrega física o más tarde. Sin hora de salida, TrakarIA usa la hora de creación; sin hora de retorno, la entrada queda abierta.

Para cambios posteriores, aumenta source_revision estrictamente. Los campos ausentes conservan su valor actual y se actualiza la misma entrada del planning, sin duplicarla. Consulta las reglas de sincronización.

Un upsert de vehículo correcto también asigna el vehículo a la organización de la clave API, para que los usuarios autorizados de ese grupo puedan verlo en TrakarIA. Repetir un upsert sin cambios reconcilia esa asignación de forma segura si faltaba.

Después de la prueba, localiza los registros en TrakarIA y límpialos con las acciones disponibles para tu grupo. La API pública permite cancelar un expediente de alquiler antes de la salida mediante POST /v1/rentals/{rental_id}/cancel; esta operación también cancela su entrada del planning. No ofrece una ruta DELETE general para vehículos o expedientes. Cancelar no elimina necesariamente su historial.

4. Continuar con la inspección

Usa el id público de la segunda respuesta para iniciar la inspección de salida. Una persona debe iniciar sesión en TrakarIA para abrir el enlace de lanzamiento. Tras la validación, recupera el informe de salida; después de la devolución, el informe de comparación. También puedes recibir webhooks firmados y recuperar eventos perdidos mediante GET /v1/events.