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.