Hub de Integração CTC

Bem-vindo à documentação técnica da API Hub de Integração CTC.

Este portal descreve como parceiros externos podem enviar dados operacionais para a plataforma CTC — de forma segura, rastreável e padronizada — usando o fluxo OAuth2 Client Credentials com Azure Entra ID.

Como funciona

ERP do parceiro
    │
    │  HTTPS + Bearer Token (OAuth2)
    ▼
API Gateway (APIM)          ← valida JWT, extrai partnerId, rate limit
    │
    │  X-Partner-Id header (interno)
    ▼
Microserviço de Ingestão    ← valida payload, persiste no Data Lake

O parceiro autentica-se no Azure Entra ID e obtém um access token.
O token é enviado como Authorization: Bearer <token> em cada requisição.
O APIM valida o token, extrai o client_id do parceiro e injeta o header X-Partner-Id internamente.
O microserviço do domínio correspondente recebe o payload, valida e persiste.

Domínios disponíveis

Domínio	Endpoint	Scope exigido
Produtividade	`POST /v1/integrations/{partnerId}/produtividade`	`productivity.write`
Plantio	`POST /v1/integrations/{partnerId}/plantio`	`planting.write`
Pragas	`POST /v1/integrations/{partnerId}/pragas`	`pests.write`
Ordem de Serviço	`POST /v1/integrations/{partnerId}/os`	`order.write`
CTT	`POST /v1/integrations/{partnerId}/ctt`	`ctt.write`
Clima	`POST /v1/integrations/{partnerId}/clima`	`climate.write`
SAT	`POST /v1/integrations/{partnerId}/sat`	`sat.write`

Primeiros passos

:material-key: Autenticação

Configure OAuth2 Client Credentials e obtenha seu primeiro token.
:material-api: Domínios

Explore os contratos de cada domínio com exemplos de payload.