SOMA API · REST

Sus datos de aviación, conectados a todos los sistemas que opera

La API de SOMA ofrece a operadores, MRO y sus equipos de TI acceso programático y seguro a los datos de flota, vuelos y mantenimiento, para que SOMA funcione de la mano con su ERP, sus tableros de BI y sus aplicaciones internas.

● ● ●
Ejemplo de solicitud
GET /api/v1/aircraft/[REGISTRATION]
Authorization: Bearer [YOUR_TOKEN]

200 OK · application/json
{
  "registration": "[REG]",
  "model": "[AIRCRAFT MODEL]",
  "totalHours": 12458.6,
  "totalCycles": 9873,
  "nextInspection": "[TASK / DUE DATE]"
}

Ejemplo ilustrativo. Endpoints y campos según la documentación oficial.

API RESTful sobre HTTPS
Respuestas en JSON
Documentación interactiva en Swagger
Acceso autenticado por organización
Por qué la API de SOMA

Deje de cargar datos dos veces. Opere de forma totalmente conectada.

SOMA ya es su única fuente de verdad sobre aeronavegabilidad. La API permite que esa información fluya al resto de su negocio de forma automática, precisa y en tiempo real.

Elimine la doble carga

Sincronice automáticamente horas de vuelo, ciclos y órdenes de trabajo entre SOMA y sus demás sistemas, y reduzca errores manuales y tiempo administrativo.

Conecte su ERP y finanzas

Comparta datos de compras, inventario y costos de mantenimiento con su ERP y sus herramientas contables, para que finanzas e ingeniería trabajen con los mismos números.

Potencie sus tableros de BI

Alimente Power BI, Looker Studio, Tableau o su data warehouse con datos de flota y mantenimiento en vivo, para los reportes que la dirección realmente necesita.

Cargas masivas y migraciones

Incorpore nuevas aeronaves o importe registros históricos a escala en lugar de cargarlos uno por uno, ideal para el crecimiento de la flota y los cambios de sistema.

Cree sus propias aplicaciones

Desarrolle portales internos, herramientas para estaciones de línea o vistas para sus clientes sobre los datos de SOMA, sin esperar el roadmap del producto.

Lista para automatización e IA

Dispare flujos de trabajo en su plataforma de automatización y entregue a las herramientas de IA datos aeronáuticos estructurados y confiables.

A qué puede acceder

Los mismos datos detrás de cada módulo de SOMA

La API expone los registros que sus equipos ya gestionan en SOMA, con las mismas reglas y permisos que los mantienen precisos.

Consulte por su caso de uso →

Flota y aeronaves

Aeronaves, componentes, horas y ciclos acumulados.

Operaciones de vuelo

Hojas de vuelo, tiempos de bloque y de vuelo, combustible y tripulación.

Mantenimiento e ingeniería

Órdenes de trabajo, tareas, inspecciones y vencimientos.

Inventario y compras

Repuestos, niveles de stock, rotables y órdenes de compra.

Documentos y cumplimiento

Certificados, licencias y fechas de vencimiento.

Cómo funciona

De la primera llamada a la integración en vivo

01

Cuéntenos qué quiere conectar

Comparta los sistemas y flujos de datos que tiene en mente. Nuestro equipo define con usted el alcance de la integración y confirma qué cubre la API.

02

Obtenga acceso y documentación

Reciba las credenciales de su organización y acceso completo a la referencia interactiva de la API, con ejemplos de solicitudes y respuestas.

03

Construya, pruebe y salga en vivo

Sus desarrolladores avanzan a su propio ritmo, o el equipo de ingeniería de SOMA la construye por usted a través de nuestro servicio de desarrollo a medida.

Para desarrolladores

Hecha para desarrolladores. Respaldada por ingenieros aeronáuticos.

Endpoints claros y documentados con los que su equipo puede empezar en minutos, y un equipo de soporte que entiende tanto el código como las normas de aeronavegabilidad detrás de los datos.

Convenciones REST estándar y payloads en JSON
Referencia interactiva en Swagger para explorar y probar endpoints
API versionada con notas de versión publicadas
Soporte técnico del equipo de ingeniería de SOMA
Autentíquese y obtenga su JWT
POST /api/auth/login
curl -X POST "https://api.somasoftware.com/soma-api-public/api/auth/login" \
  -H "Content-Type: application/json" \
  -H "Authorization: Basic <BASE64_OF_YOUR_CREDENTIALS>" \
  -d '{"username": "YOUR_ACCOUNT@YOUR_COMPANY.com", "password": "YOUR_PASSWORD"}'
import requests

response = requests.post(
    "https://api.somasoftware.com/soma-api-public/api/auth/login",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Basic <BASE64_OF_YOUR_CREDENTIALS>",
    },
    json={
        "username": "YOUR_ACCOUNT@YOUR_COMPANY.com",
        "password": "YOUR_PASSWORD",
    },
)
print(response.json())  # includes the JWT for your next requests
const response = await fetch(
  "https://api.somasoftware.com/soma-api-public/api/auth/login",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Authorization": "Basic <BASE64_OF_YOUR_CREDENTIALS>",
    },
    body: JSON.stringify({
      username: "YOUR_ACCOUNT@YOUR_COMPANY.com",
      password: "YOUR_PASSWORD",
    }),
  }
);
const data = await response.json(); // includes the JWT for your next requests

Use el JWT obtenido en el header Authorization de cada solicitud siguiente.

Preguntas frecuentes

¿Quién puede usar la API de SOMA?
arrow

La API está disponible para organizaciones con una suscripción activa de SOMA que agreguen el acceso a la API a su plan. El acceso se otorga por organización, por lo que cada integración solo ve sus propios datos.

¿El acceso a la API tiene un costo adicional?
arrow

Sí. El acceso a la API es una suscripción adicional a su plan de SOMA. Contacte a nuestro equipo y le prepararemos una propuesta según las necesidades de su integración.

¿Qué tipo de API es?
arrow

Es una API REST que funciona sobre HTTPS e intercambia datos en JSON, por lo que es compatible con prácticamente cualquier lenguaje de programación, ERP, herramienta de BI o plataforma de automatización.

¿Hay documentación disponible?
arrow

Sí. Una vez que su organización obtiene acceso, su equipo recibe una referencia interactiva en Swagger con todos los endpoints disponibles, sus parámetros y ejemplos de respuesta, para que los desarrolladores exploren y prueben las llamadas directamente desde el navegador.

¿Puedo escribir datos en SOMA o solo leerlos?
arrow

Ambas cosas. Puede consultar registros y también crearlos o actualizarlos; por ejemplo, cargar horas de vuelo desde otro sistema.

¿Cómo se protegen mis datos?
arrow

La autenticación se basa en JWT (JSON Web Tokens). Su integración inicia sesión con las credenciales de su organización, recibe un token y lo envía en cada solicitud. Todo el tráfico viaja cifrado por HTTPS y cada integración solo accede a los datos de su propia organización.

No tenemos desarrolladores. ¿SOMA puede construir la integración?
arrow

Sí. A través de nuestro servicio de Desarrollo Aeronáutico Personalizado, los ingenieros de SOMA pueden diseñar y construir por usted la integración con su ERP, su herramienta de BI o sus sistemas internos.

¿Hay límites de uso?
arrow

Sí. La suscripción estándar de la API incluye hasta 30.000 solicitudes por mes y 1.000 solicitudes por día (una solicitud es cualquier llamada GET, POST, PUT, PATCH o DELETE). Si su integración necesita mayor volumen, nuestro equipo le cotizará una ampliación.