Pular para o conteúdo

API: chave, rotas e limites

A API REST faz os mesmos cálculos das calculadoras e devolve o resultado em JSON. Também lê índices e tabelas de tribunais e salva cálculos no escritório. A documentação da API mostra cada rota com um exemplo de requisição e a resposta real.

Rotas principais

Rota Para quê
POST /api/v1/{tipo} calcula. Tipos: atualizacao, reajuste-aluguel, financiamento, pensao-alimenticia, justica-federal, superendividamento, revisao-financiamento, precatorio, atrasados-inss, tempo-contribuicao, trabalhista, cartao-ponto, pis-cofins-icms, reforma-tributaria, rmi, pensao-vitalicia, valor-causa, cumprimento-sentenca (o endereço da calculadora também vale)
GET /api/v1/indices e /api/v1/indices/{codigo} índices e valores
GET /api/v1/tabelas e /api/v1/tabelas/{codigo} tabelas de tribunais, com a edição importada
GET /api/v1/calculos e POST /api/v1/calculos listar e salvar cálculos do escritório (exige chave)
GET /api/v1/calculos/{id} abrir um cálculo do escritório (exige chave)

Todo resultado de cálculo traz regra_validada e nao_validado: quando o cálculo usou uma regra ainda sem conferência em fonte independente, regra_validada vem false e a lista diz qual.

Perguntas frequentes

Onde está a documentação completa? Em /api/docs: autenticação, limites e cada rota com exemplo de requisição e de resposta.

Como pego a chave? O dono do escritório cria em "Escritório" › "Chaves de API". A chave aparece uma vez só: copie na hora. Os membros veem a lista de chaves, mas só o dono cria e revoga.

Como envio a chave? No cabeçalho Authorization: Bearer <chave>.

Funciona sem chave? Para calcular e consultar índices e tabelas, sim, com limite de 30 cálculos por hora por rede (acima disso, erro 429). Listar e salvar cálculos exige chave.

Apareceu o erro 401 "Chave de API inválida ou revogada". A chave foi digitada errado ou o dono a revogou. Crie outra.

Dá para usar a Exatajus dentro do Claude? Sim, pelo servidor MCP, com a mesma chave de API. O passo a passo está em Servidor MCP da Exatajus e no artigo Usar a Exatajus no Claude (MCP). O ChatGPT ainda não conecta: ele exige login por OAuth, que a Exatajus ainda não oferece.

Preciso de ajuda com a integração. Fale com a gente com o assunto "API e integração", dizendo a rota e o corpo que você enviou (sem a chave).

Não resolveu? Fale conosco.