API REST v1

Integre SafraCheck.IA ao seu fluxo

API REST para cooperativas, bancos, fintechs agro e ERPs que querem consumir o motor de prontidão documental como serviço. Disponível em planos Coop Plus e Enterprise.

Autenticação

Bearer token com chave por organização (uma chave por tenant).

curl -H "Authorization: Bearer sk_org_<seu_token>" \
     https://safracheck-ia.vercel.app/api/v1/proposals

Endpoints v1

GET

/api/v1/proposals

Lista propostas da organização. Suporta `limit` e `status`.

POST

/api/v1/proposals

Cria proposta vinculada à organização e gera checklist dinâmico.

{
  "title": "Custeio Soja Sorriso/MT 25/26",
  "safra": "2025/2026",
  "proposerType": "pessoa_fisica",
  "producerCategory": "medio_produtor",
  "state": "MT",
  "city": "Sorriso",
  "activity": "lavoura",
  "crop": "soja",
  "creditLine": "pronamp_custeio",
  "creditPurpose": "custeio",
  "requestedAmount": 1500000,
  "externalUserEmail": "produtor@cooperativa.com.br"
}

GET

/api/v1/proposals/{id}

Detalhes completos: score, checklist, documents, findings, validações automáticas, trilha auditável + hash SHA-256.

webhooks

POST {sua_url}/safracheck-event

Eventos: proposal.created, score.updated, document.processed, finding.critical, report.exported.

Como obter a chave

Plano Coop Plus ou Enterprise. Mande mensagem para vendas — geramos a chave em até 24h.

Limites e SLA: Coop Plus = 500 chamadas/dia. Enterprise = ilimitado + SLA contratual 99,5%. Logs de auditoria de cada chamada disponíveis por 365 dias.