Recursos da API

Motor de Score de Crédito (IA)

O coração da Kima Kudi: um motor de decisão que estrutura os dados extraídos por OCR, calcula o score de risco e gera uma justificação legível para o analista ou para o cliente final. Pode ser consumido diretamente para instituições que já têm o seu próprio fluxo documental.

POST /v1/scoring/estruturar Requer Bearer token

Converte texto bruto de OCR num objeto estruturado, de acordo com o tipo de documento fornecido.

Pedido

JSON

{
  "texto_ocr": "REPUBLICA DE ANGOLA ... BI N. 004587412LA034",
  "tipo_documento": "bi"
}

Resposta 200

application/json

{
  "nome_completo": "João Manuel da Silva",
  "numero_documento": "004587412LA034",
  "data_nascimento": "1990-04-12"
}

POST /v1/scoring/avaliar Requer Bearer token

Calcula o score de crédito e a decisão (aprovado/recusado) a partir dos dados já estruturados do cliente.

Pedido

JSON

{
  "dados_estruturados": {
    "comprovativo_rendimento": { "rendimento_mensal": 320000 },
    "extrato_bancario": { "saldo_medio": 180000 }
  },
  "valor_solicitado": 850000,
  "prazo_meses": 24
}

Resposta 200

application/json

{
  "aprovado": true,
  "score": 742,
  "classificacao": "baixo_risco",
  "taxa_esforco": 0.28,
  "motivos": [
    "Rendimento mensal estável",
    "Taxa de esforço dentro do limite recomendado"
  ]
}

POST /v1/scoring/justificar Requer Bearer token

Gera uma justificação em linguagem natural para o score calculado, adequada para apresentação ao cliente final ou a um analista de crédito.

POST /v1/scoring/extract-transactions Requer Bearer token

Extrai a lista estruturada de transações a partir do texto OCR de um extrato bancário.

POST /v1/scoring/recommendations Requer Bearer token

Gera recomendações de poupança e saúde financeira personalizadas, com base no histórico de transações do cliente.