API de servicios web – Descripción general y primeros pasos
La API de servicios web de TripLog le permite integrar los datos de TripLog directamente en sus propios sistemas. Úsela para obtener registros de viajes, administrar usuarios, extraer datos de gastos y más, todo mediante solicitudes HTTP estándar y JSON.
Quién puede usarla: La API está disponible para los suscriptores del plan Enterprise. El acceso a la API se administra a nivel de organización por un administrador principal.
URL base
Todas las solicitudes de la API se realizan a:
https://app.triplog.net/web/api/
Autenticación
Cada solicitud debe incluir la clave de API de su organización en el encabezado Authorization:
Authorization: apikey YOUR_API_KEY
Para generar u obtener su clave de API, consulte Cómo generar la clave de API.
Mantenga su clave de API segura. Otorga acceso completo de lectura/escritura a los datos de su organización. No la exponga en código del lado del cliente ni en repositorios públicos.
Formato de solicitud
Protocolo: Solo HTTPS
Método: GET o POST según el endpoint (indicado en cada artículo)
Content-Type:
application/jsonpara solicitudes POST con un cuerpo de solicitudFormato de respuesta: JSON
Tamaño de la respuesta
Los endpoints que devuelven listas (como /trips y /users) devuelven todos los registros coincidentes en una sola respuesta: no hay paginación. Para organizaciones con grandes volúmenes de datos, esto puede generar cargas útiles muy grandes.
Para mantener manejable el tamaño de las respuestas:
Use los parámetros de rango de fechas disponibles para acotar su consulta (por ejemplo,
startDate/endDateen el endpoint de Viajes)Evite realizar consultas sin filtros a menos que se pretenda una exportación completa de datos
Códigos de estado HTTP
Código | Significado |
| Éxito |
| Solicitud incorrecta: verifique sus parámetros |
| No autorizado: falta la clave de API o es inválida |
| Prohibido: su plan no incluye acceso a la API |
| Recurso no encontrado |
| Error del servidor: reintente después de un breve momento |
Endpoint | Descripción |
Enumerar y administrar los usuarios de su organización | |
Ubicación en tiempo real de un usuario | |
Obtener registros de viajes con filtrado por usuario y fecha | |
Obtener puntos de referencia GPS de un viaje específico | |
Gestión de aprobación de viajes | |
Estadísticas de kilometraje por usuario o período | |
Administración de ubicaciones de usuario | |
Registros de vehículos de su organización | |
Registros de gastos | |
Gestión de aprobación de gastos | |
Imágenes de recibos y metadatos | |
Crear y administrar etiquetas personalizadas para viajes y gastos | |
Acceder al registro de auditoría de las aprobaciones | |
Registros de seguimiento de tiempo por usuario y rango de fechas | |
Kilometraje desglosado por estado de EE. UU. |