eximIA
Integration Hub
Contract v1Contrato Universal de Integração

Um contrato. Qualquer app conectado.

Implemente 5 endpoints e seu app se torna automaticamente conectável a qualquer outro do ecossistema eximIA — presente ou futuro.

Ler documentaçãoSpec JSON

Princípios

Zero Hardcoding

Nenhum app conhece a lista de outros apps de antemão

Discovery-based

O /catalog é o mecanismo de descoberta automática

Sem intermediário

Apps se conectam ponto-a-ponto. Hub documenta, não proxeia

Agent-friendly

Spec servido como JSON para agentes implementarem

Endpoints Obrigatórios

GET/api/v1/integration/catalog
GET/api/v1/integration/:entity
POST/api/v1/integration/:entity
GET/api/v1/integration/:entity/:id
PUT/api/v1/integration/:entity/:id

Quick Start

1

Consumir a spec

GET /api/spec retorna o contrato completo em JSON. Agentes podem consumir e gerar código automaticamente.

2

Implementar endpoints

Crie os 5 endpoints no app. O /catalog define o que o app expõe ao ecossistema.

3

Descobrir & conectar

Qualquer app chama /catalog de outro e descobre automaticamente as entidades disponíveis.

Autenticação

x-eximia-api-key: eximia_<app>_<random32>
readwriteadmin

Cada app gerencia suas próprias API keys. Hash SHA-256 no banco — nunca a key raw. O Hub não centraliza gestão de keys.