API Reference

LogisticsHub REST API v1

Integra facturación CFDI 4.0, Carta Porte 3.1, seguimiento GPS y gestión de flota directamente en tus sistemas. Autenticación via API Keys con permisos granulares.

Base URL

https://api.logisticshub.mx/v1

Autenticación

Bearer JWT Token

Rate Limit

1,000 req/min

Autenticación

Todas las peticiones requieren un token Bearer JWT. Obtén tus credenciales desde Configuración → API Keys.

bash

# 1. Obtén un token de acceso
curl -X POST 'https://api.logisticshub.mx/v1/auth/token' \
  -H 'Content-Type: application/json' \
  -d '{"client_id": "lh_key_...", "client_secret": "lh_sec_...", "grant_type": "client_credentials"}'

# 2. Usa el token en cada petición
curl 'https://api.logisticshub.mx/v1/invoices' \
  -H 'Authorization: Bearer eyJhbGciOi...'

Rate Limiting

La API permite 1,000 requests por minuto por API Key. Los headers de respuesta incluyen el estado del rate limit:

Header	Descripción
`X-RateLimit-Limit`	Límite de requests por ventana
`X-RateLimit-Remaining`	Requests restantes en la ventana actual
`X-RateLimit-Reset`	Timestamp Unix cuando se renueva el límite

Si excedes el límite, recibirás un 429 Too Many Requests. Implementa exponential backoff en tus integraciones.

Errores

Todas las respuestas de error siguen el mismo formato JSON:

json

{
  "error": "Invoice not found",
  "details": [
    { "field": "id", "message": "No existe una factura con el ID proporcionado" }
  ]
}

400

Bad Request

401

Unauthorized

404

Not Found

429

Rate Limited

Autenticación

Obtén y gestiona tokens de acceso para la API

1 endpoint

Clientes

Gestiona la base de clientes y su información fiscal

3 endpoints

Facturas CFDI

Crea, timbra y gestiona facturas CFDI 4.0

6 endpoints

Carta Porte

Complemento Carta Porte 3.1 para transporte de mercancías

3 endpoints

Envíos

Gestiona viajes, seguimiento GPS y entregas

2 endpoints

Vehículos

Administra tu flota vehicular

1 endpoint

Entregas

Gestiona el estado de entregas individuales

1 endpoint

Mantenimiento

Registra y consulta el mantenimiento preventivo de la flota

1 endpoint

Listo para integrar?

Crea tu API Key desde el panel de configuración y comienza a usar la API en minutos.

Crear API Key Contactar soporte

# 1. Obtén un token de acceso curl -X POST 'https://api.logisticshub.mx/v1/auth/token' \ -H 'Content-Type: application/json' \ -d '{"client_id": "lh_key_...", "client_secret": "lh_sec_...", "grant_type": "client_credentials"}' # 2. Usa el token en cada petición curl 'https://api.logisticshub.mx/v1/invoices' \ -H 'Authorization: Bearer eyJhbGciOi...'

Header

Descripción

X-RateLimit-Limit

Límite de requests por ventana

X-RateLimit-Remaining

Requests restantes en la ventana actual

X-RateLimit-Reset

Timestamp Unix cuando se renueva el límite