Buscar e conferir fontes oficiais
A API da FonteIA permite consultar documentos e evidências por área e coleção. Tributário e Fiscal oferece busca nas fontes habilitadas; Relações Trabalhistas tem consulta documental parcial. Jurisprudências ainda não está disponível. Consulte a disponibilidade antes de escolher a operação.
Os resultados dependem das fontes disponíveis no acervo. Preserve os links oficiais e as limitações retornadas: um trecho encontrado não representa, por si só, a leitura integral do documento nem a cobertura completa de um tema.
Autenticação
Inclua uma chave de API no cabeçalho Authorization de cada solicitação. A documentação é pública; as consultas exigem uma credencial válida e as respectivas permissões de acesso.
Authorization: Bearer SUA_CHAVE_APIAcesse sua conta para consultar e gerenciar suas credenciais.
Não publique sua chave no navegador, em repositórios ou em documentos compartilhados.
URL base
https://api.fonteia.ai/v1Envie e receba JSON. Nas requisições com corpo, utilize Content-Type: application/json.
Buscar evidências oficiais
POST/evidence/search
Use operation=list_research_channels para consultar a disponibilidade dos canais. Selecione research_channel antes da pesquisa; source_groups restringe as fontes dentro desse canal. Omitir o canal mantém tributario_fiscal por compatibilidade, sem pesquisar automaticamente em todas as áreas.
| Parâmetro | Descrição |
|---|---|
query | Consulta curta e objetiva, quando exigida pela operação. |
research_channel | tributario_fiscal, relacoes_trabalhistas ou jurisprudencias. O catálogo informa o que está habilitado. |
domain | Campo de compatibilidade; padrão reforma_tributaria. Não substitui a seleção de canal nem define toda a cobertura da plataforma. |
source_groups | Lista opcional de identificadores de grupos de fontes. |
limit | Até 10 evidências no contrato tributário; operações trabalhistas têm limites próprios, até 5. Confira o OpenAPI. |
profile | sources_only ou interactive_fast; padrão sources_only. |
purpose | Contexto opcional de uso da consulta. |
curl -X POST 'https://api.fonteia.ai/v1/evidence/search' \
-H "Authorization: Bearer $FONTEIA_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"query":"documentos fiscais IBS CBS 2026","research_channel":"tributario_fiscal","limit":5}'Formular a consulta
Use termos concretos e confira as fontes antes de utilizá-las como fundamento. Em Relações Trabalhistas, as operações incluem descoberta e leitura de instrumentos coletivos por identidade, consulta de SST e catálogo de Obrigações do Empregador por tema. Preserve document_id, version_id, snapshot e a continuação indicada pelo contrato. A cobertura é parcial e a consulta não determina enquadramento, vigência atual ou aplicabilidade ao caso. As operações documentais são search_collective_documents, read_collective_document, search_sst_documents, read_sst_document, search_employer_documents e read_employer_document.
Consultar um documento
POST/documents/lookup
Esta operação auxiliar mantém seu contrato tributário de lookup. Envie a referência no campo query; o domínio de compatibilidade é reforma_tributaria. Para documentos trabalhistas, use as operações de descoberta e leitura de /evidence/search, com versão e paginação.
curl -X POST 'https://api.fonteia.ai/v1/documents/lookup' \
-H "Authorization: Bearer $FONTEIA_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{"query":"Lei Complementar 214 de 2025"}'O que cada evidência retorna
Os resultados de busca incluem o trecho recuperado e os dados disponíveis para rastrear sua origem. Consulte o esquema OpenAPI para os campos de cada operação.
- Identificação da evidência e do documento de origem.
- Texto do trecho oficial e informações da fonte.
- Referência e URL oficial, quando disponíveis.
- Metadados e limitações da recuperação.
Preserve a distinção entre o texto da fonte e a resposta gerada. Não preencha dados ausentes com informações presumidas.
Respostas para sua aplicação
POST/answers
No canal tributário, gera uma resposta rápida acompanhada das citações disponíveis. O modo aceito é fast; max_citations admite de 1 a 5, com padrão 3. A síntese jurídica trabalhista não está habilitada: use a busca e a leitura documental. Jurisprudências permanece indisponível.
{
"question": "Como ficam PIS e Cofins com a CBS?",
"research_channel": "tributario_fiscal",
"domain": "reforma_tributaria",
"mode": "fast",
"max_citations": 3
}O contrato também oferece POST /impact/brief, GET /changes/recent e POST /timeline. Os corpos de requisição e esquemas de resposta estão na especificação OpenAPI.
Limites e erros
O acesso depende das permissões e da cota da conta. Consulte as condições vigentes em Planos. Trate falhas de autenticação, parâmetros inválidos e limites de uso antes de processar a resposta.
400: requisição ou argumentos inválidos.401: autenticação ausente ou inválida.403: operação sem permissão.429: limite de uso atingido.5xx: falha no serviço; não equivale à ausência de fontes.
Confira também as limitações informadas no JSON. Uma resposta sem evidências suficientes não deve ser apresentada como conclusão comprovada. Canal desconhecido ou parâmetros incompatíveis podem retornar 422; canal indisponível retorna 503, sem fallback para outra área.
Referência e conexões
Para conectar um assistente, consulte o servidor MCP e os guias de Claude e ChatGPT.
Abrir especificação OpenAPIDúvidas técnicas: developer@fonteia.ai.