VíaSuite API
Integra tu agencia de viajes con cualquier plataforma. Accede a expedientes, clientes, cotizaciones y más — en tiempo real.
https://app.viasuite.app/v1/
API Operacional
🔐 Autenticación
Todas las requests requieren un API key en el header Authorization.
# Ejemplo con curl
curl https://app.viasuite.app/v1/agency/me \
-H "Authorization: Bearer vs_live_xxxxxxxxxxxxxxxxxxxx"
// Ejemplo con JavaScript
const response = await fetch('https://app.viasuite.app/v1/expedientes', {
headers: {
'Authorization': 'Bearer vs_live_xxxxxxxxxxxxxxxxxxxx',
'Content-Type': 'application/json'
}
});
const data = await response.json();
⚠️ Genera tu API key en app.viasuite.app → Configuración → API o usando el endpoint POST /v1/keys.
⚠️ Códigos de error
| Código | Significado | Solución |
|---|---|---|
| 200 | OK | Request exitosa |
| 201 | Created | Recurso creado exitosamente |
| 400 | Bad Request | Faltan campos requeridos |
| 401 | Unauthorized | API key inválida o faltante |
| 403 | Forbidden | Cuenta suspendida |
| 404 | Not Found | Recurso no encontrado |
| 500 | Server Error | Error interno, contacta soporte |
🏢 Agencia
GET
/v1/agency/me
Datos de tu agencia
// Respuesta
{
"success": true,
"data": {
"id": "00000000-0000-0000-0000-000000000001",
"name": "Travel Advisors Panama",
"email": "zenen@traveladvisorspty.net",
"plan": "pro",
"status": "active",
"country": "Panama"
}
}
📁 Expedientes
GET
/v1/expedientes
Listar expedientes
Parámetros opcionales:
| Parámetro | Tipo | Descripción |
|---|---|---|
| limit | integer | Máx resultados (default: 50) |
| offset | integer | Paginación (default: 0) |
| status | string | Filtrar por: nuevo, activo, cerrado |
POST
/v1/expedientes
Crear expediente
| Campo | Tipo | Descripción |
|---|---|---|
| clientName* | string | Nombre del cliente |
| destination | string | Destino del viaje |
| dateFrom | date | YYYY-MM-DD |
| dateTo | date | YYYY-MM-DD |
| paxAdult | integer | Adultos (default: 1) |
| notes | string | Notas adicionales |
🤖 IA / Chatbot
Integra un asistente de IA que conoce tus expedientes y puede crear cotizaciones desde lenguaje natural. Perfecto para conectar con WhatsApp, chatbots y herramientas como Darwin AI.
POST
/v1/ai/query
Consulta en lenguaje natural
// Request
{
"message": "¿Cuántos expedientes activos tengo este mes?"
}
// Response
{
"success": true,
"data": {
"reply": "Tienes 12 expedientes activos este mes. Los destinos más frecuentes son Cancún (4) y Miami (3)."
}
}
POST
/v1/ai/quote
Crear cotización desde texto
// Request — Mensaje del cliente por WhatsApp
{
"message": "Hola quiero viajar a Roma con mi esposa del 15 al 25 de enero"
}
// Response — Expediente creado automáticamente
{
"success": true,
"data": {
"extracted": {
"destination": "Roma, Italia",
"dateFrom": "2027-01-15",
"dateTo": "2027-01-25",
"paxAdult": 2
},
"expediente": { "id": "...", "no": "7401" }
}
}
🧪 API Playground — Prueba en vivo
API KEY
ENDPOINT
// La respuesta aparecerá aquí...
📦 SDKs y librerías
Próximamente. Por ahora usa fetch o axios directamente.
// JavaScript / Node.js — sin SDK
const viasuite = {
baseUrl: 'https://app.viasuite.app/v1',
key: 'vs_live_xxxx',
async get(path) {
const r = await fetch(`${this.baseUrl}${path}`, {
headers: { 'Authorization': `Bearer ${this.key}` }
});
return r.json();
}
};
// Uso
const expedientes = await viasuite.get('/expedientes?limit=10');
VíaSuite
API v1 · docs.viasuite.app · hola@viasuite.app