API RESTFUL • DOCUMENTACIÓN DE INTEGRACIÓN • VER 2026

Developer Hub

NexGestion expone una API REST robusta diseñada para la interoperabilidad total. Desde la captura de leads hasta la gestión de módulos de terceros, cada interacción está gobernada por contratos JSON estrictos.

Flujo de Integración

FASE 1

Autenticación

Todas las peticiones requieren una API Key válida gestionada desde el panel de administración.

Authorization: Bearer nex_live_xxxxxxxxxxxx
# O bien
X-API-Key: nex_live_xxxxxxxxxxxx

Health Check: GET /api/v1/ping

FASE 2

Descubrimiento

Consulte sus capacidades permitidas antes de operar.

GET /api/v1/capabilities
FASE 3

Recursos Core

NexGestion ofrece recursos estándar para el ciclo de vida comercial:

  • /prospects: Captura de leads.
  • /clients: Cartera de clientes.
  • /tickets: Soporte técnico.
FASE 4

Extensibilidad

Siga este checklist para exponer sus datos en un nuevo módulo:

  1. 1. Cree el recurso en api/resources/.
  2. 2. Registre las rutas en api/index.php.
  3. 3. Proteja con Auth::requireScope().
  4. 4. Añada la definición en api/openapi.json.
FASE 5

Validación

El request_id es obligatorio para el soporte técnico.

{
  "ok": true,
  "message": "Operación exitosa",
  "data": { ... },
  "request_id": "req_550e8400"
}

Referencia Técnica

OpenAPI 3.0 Spec

Importe nuestra definición completa en Postman o Swagger UI.

URL: nexgestion.es/api/openapi.json