API Documentation

Autenticação

Bearer JWT Tokens

Todas as requisições à API devem incluir um token JWT válido no header Authorization. Tokens são obtidos através do endpoint de autenticação e possuem validade de 24 horas.

POST
/api/v1/auth/token

// Requisição

{

  "email": "advogado@escritorio.com.br",

  "api_key": "dk_live_xxxxxxxxxxxxxxxxxxxxxxxx"

}

// Resposta (200 OK)

{

  "token": "eyJhbGciOiJIUzI1NiIs...",

  "expires_in": 86400,

  "token_type": "Bearer"

}

Uso em todas as requisições

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Content-Type: application/json

Endpoints Disponíveis

Recursos da API

Casos

POST /api/v1/cases Criar novo caso

Cria um novo caso informando número do processo, vara, partes e tipo de ação. Retorna o ID do caso para uso nos endpoints subsequentes.

GET /api/v1/cases Listar casos

Lista todos os casos da conta com status de processamento, data de criação e resumo. Suporta paginação e filtros por status.

GET /api/v1/cases/{id} Detalhes do caso

Retorna detalhes completos do caso, incluindo status de processamento, hashes SHA-256, contagem de evidências e progresso da análise.

DELETE /api/v1/cases/{id} Excluir caso

Exclui permanentemente o caso e todos os dados associados. Esta ação não pode ser revertida. Casos já processados terão seus relatórios excluídos.

Upload e Processamento

POST /api/v1/cases/{id}/upload/whatsapp Upload do .zip de WhatsApp

Upload do arquivo .zip exportado do WhatsApp. Aceita multipart/form-data. Tamanho máximo: 2GB. O sistema inicia a extração automaticamente após o upload.

POST /api/v1/cases/{id}/upload/petition Upload da petição inicial

Upload do PDF da petição inicial para extração automática dos pedidos. Aceita application/pdf. Tamanho máximo: 50MB.

POST /api/v1/cases/{id}/process Iniciar processamento

Inicia o processamento completo do caso (transcrição, OCR, análise por IA, geração de relatório). Retorna imediatamente com status 202 Accepted. Use o endpoint de status ou configure um webhook para ser notificado da conclusão.

GET /api/v1/cases/{id}/status Status do processamento

Retorna o status atual do processamento: queued, extracting, transcribing, analyzing, generating, completed, failed. Inclui percentual de progresso e estimativa de tempo restante.

Relatórios e Resultados

GET /api/v1/cases/{id}/report Download do relatório forense

Download do relatório forense completo em PDF. Disponível após a conclusão do processamento. Inclui cadeia de custódia, transcrições, análise e contradições mapeadas.

GET /api/v1/cases/{id}/contestation Download da contestação

Download da contestação editável em formato DOCX, compatível com o PJe. Inclui fundamentação legal, referências às evidências e artigos da CLT aplicáveis.

GET /api/v1/cases/{id}/hashes Hashes SHA-256 do caso

Retorna todos os hashes SHA-256 individuais e o hash mestre do caso em formato JSON. Pode ser utilizado para verificação independente da integridade das evidências.

Webhooks

POST /api/v1/webhooks Configurar webhook

Registra uma URL de callback para receber notificações de eventos: case.completed, case.failed, upload.completed. O payload inclui o ID do caso e metadados relevantes. Assinatura HMAC-SHA256 para verificação.