Introduccion - Lumos CRM Docs

Alcance

La API publica de Lumos CRM permite integrar sistemas externos para consultar, crear y sincronizar informacion comercial.

Especificacion OpenAPI

Lumos CRM OpenAPI

Consulta el contrato base para autenticacion, endpoints y payloads.

Acceso a endpoints de integracion

Para consumir endpoints bajo /integrations/v1 debes enviar:

x-api-key: API key de integraciones del tenant.
tenantId: en query/body segun el endpoint. Opcionalmente puedes usar x-tenant-id.

Como gestionar la API key (solo perfil admin)

Ingresa a la consola de administracion de Lumos con un usuario admin del tenant.
Consulta el estado de la API key del tenant desde el modulo de integraciones.
Genera o rota la API key desde la misma consola y guardala en tu gestor de secretos.

Los endpoints /integrations/api-key y /integrations/api-key/generate son administrativos y su uso operativo se gestiona via consola de administracion.

Ejemplo rapido

curl --request GET \
  --url "https://lumos-am-prd.azure-api.net/api/external/integrations/v1/accounts?tenantId=<tu_tenant_id>" \
  --header "x-api-key: <tu_api_key_de_integraciones>"

Esquemas de seguridad

"securitySchemes": {
  "apiKeyAuth": {
    "type": "apiKey",
    "in": "header",
    "name": "x-api-key"
  },
  "bearerAuth": {
    "type": "http",
    "scheme": "bearer",
    "bearerFormat": "JWT"
  }
}

Mantén rotación periódica de API keys por tenant y evita exponerlas en logs o repositorios.

​Alcance

​Especificacion OpenAPI

Lumos CRM OpenAPI

​Acceso a endpoints de integracion

​Como gestionar la API key (solo perfil admin)

​Ejemplo rapido

​Esquemas de seguridad

Alcance

Especificacion OpenAPI

Acceso a endpoints de integracion

Como gestionar la API key (solo perfil admin)

Ejemplo rapido

Esquemas de seguridad