TVG SHORTENER
API RESTful v1 Oficial • JSON • OpenAPI 3.0

Documentación de la API REST

Integra el generador de enlaces cortos, consulta de analíticas y códigos QR en tus sistemas, CRMs, bots de WhatsApp y apps.

📄 Especificación OpenAPI 3.0 ⚡ Estado del Servicio (Health)
Base URL de la API
https://short.mitravel.com.mx/api/v1
Protocolo HTTPS requerido
Autenticación
🔓 Acceso Abierto
Header: X-API-KEY o Authorization: Bearer
Formato de Respuesta
application/json
UTF-8 estricto
POST /api/v1/shorten

Acorta una URL con alias opcional, título y fecha de expiración.

// Payload JSON:
{
  "url": "https://mitravel.com.mx/promo",
  "custom_slug": "verano2026",
  "title": "Campaña Verano",
  "expires_at": "2026-12-31 23:59:59"
}
POST /api/v1/bulk-shorten

Acorta hasta 50 URLs en una sola llamada por lote.

// Payload JSON:
{
  "links": [
    {"url": "https://mitravel.com.mx/tour1"},
    {"url": "https://mitravel.com.mx/tour2", "custom_slug": "t2"}
  ]
}
GET /api/v1/urls

Lista enlaces con paginación, filtros de estado y búsqueda.

Parámetros Query: ?page=1&limit=20&search=cancun&status=active

GET /api/v1/stats/{code}

Obtiene métricas de clics, desglose por dispositivo, navegador y referers.

Ejemplo: /api/v1/stats/demo

GET /api/v1/qr/{code}

Genera información del código QR y URL de descarga en imagen.

Parámetros: ?size=300

GET /api/v1/health

Monitoreo de estado operativo, latencia de base de datos y métricas globales.

Consola de Pruebas en Vivo

Ejecuta llamadas reales a los endpoints de la API y visualiza la respuesta JSON al instante.

// Haz clic en "Enviar" o en "Probar Petición" arriba para ver la respuesta aquí...