Documentação pública · Versão 1.1

Serviços, preços e soluções acessíveis por API.

A API pública da Quaerion entrega informações em JSON para pessoas, buscadores e agentes. A consulta é somente leitura, por HTTPS, sem chave ou cadastro.

Especificação OpenAPI · Documentação completa em Markdown

Endpoints

Substitua {sku} pelo identificador do catálogo, como AUT-01. A busca /services aceita filtros; os documentos de preços e soluções continuam disponíveis integralmente. HEAD retorna o mesmo status e cabeçalhos sem corpo. Métodos de escrita são recusados com HTTP 405.

Buscar e comparar serviços

Use query com até 120 caracteres para buscar todos os termos em SKU, nome, categoria, descrição, público e objetivo, sem diferenciar caixa ou acentos. category recebe o código da família, como AUT ou DAT. limit aceita inteiros de 1 a 50 e usa 20 por padrão.

A resposta informa services, total e nextCursor. Para continuar, envie o deslocamento decimal em cursor, mantendo os filtros e conferindo updatedAt. O limite do cursor é 1000; nextCursor: null encerra a leitura. Parâmetros desconhecidos, repetidos ou fora dos limites retornam HTTP 400.

const response = await fetch(
  'https://quaerion.com.br/api/public/services?query=automacao&category=AUT&limit=10',
  { credentials: 'omit' }
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { services, nextCursor, conditions, source } = await response.json();

Jornada e escopo público

O detalhe de um serviço apresenta service.guide com insumos, entregas, etapas, critérios de aceite, limites, indicadores e comparação. meetings e faqs esclarecem participação do cliente e dúvidas de contratação. A lista traz purpose e deliveryHighlights para apoiar a escolha.

O AI Referral Engine™ organiza o método público. Diagnóstico, Estratégia, Execução e Monitoramento se adaptam à modalidade contratada. Quantidades, revisões, responsabilidades e agenda dependem da proposta e da confirmação da equipe. As datas de cada guia indicam publicação e revisão material. A apresentação pública não inclui prompts, fórmulas ou procedimentos proprietários.

Solicitação para revisão humana

O endpoint /service-briefs/{sku} entrega um modelo vazio com contexto da empresa, objetivo, escopo e condições a discutir. brief.submission.url aponta ao contato humano; acceptedViaThisApi, createsContract, createsPayment e reservesTime são false.

Consultar o modelo não envia briefing, confirma reunião ou gera cobrança. A API não recebe POST. Compartilhe informações no canal adequado ao atendimento, sem incluir senhas ou dados sensíveis no modelo público.

Consultar preços

const response = await fetch('https://quaerion.com.br/api/public/prices.json');
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { services } = await response.json();

Cada serviço preserva implantação (setup) e recorrência (recurrence) separadamente. Use seus textos label ao apresentar uma referência. Valores definidos usam reais brasileiros (BRL); campos ausentes não significam preço zero.

Consulte billingModel, unit, timeframe, contract, conditions e a data em source antes de apresentar uma estimativa. openEnded indica uma faixa sem teto publicado. Valores por mês, projeto ou hora não são intercambiáveis. Veja os preços e suas condições.

Aplicações por segmento

As soluções descrevem contexto, público e perguntas frequentes. publishedAt e updatedAt informam publicação original e revisão material de cada página. São aplicações possíveis dos serviços; não equivalem a depoimentos, cases ou garantia de resultado. Use a URL canônica de cada solução ao citar a informação.

Descoberta e uso por agentes

• Catálogo de APIs no formato RFC 9727
• Agent Skills Discovery v0.2 com hashes SHA-256
• Política de acesso e autenticação
• Índice de conteúdo para agentes

O site registra ferramentas WebMCP de leitura em navegadores que oferecem a API. Os dados seguem disponíveis por HTTPS quando esse recurso não é suportado.

Limites da integração

As novas rotas retornam erros em JSON: 400 para consulta inválida, 404 para serviço ou endpoint ausente, 405 para método recusado e 503 quando os dados estão indisponíveis. CORS permite leitura pública sem credenciais. Os cabeçalhos Link apontam catálogo, OpenAPI e documentação.

Consultar dados não contrata serviços, cria contas, envia mensagens ou autoriza pagamentos. Respeite os cabeçalhos de cache; confira as condições atuais antes de compor uma proposta. Não envie senhas, tokens, dados pessoais ou informações de saúde nestas consultas.

Esta API não anuncia servidores OAuth, A2A, MCP remoto ou protocolos de pagamento. Essas integrações precisam existir e ser validadas antes de receber documentos de descoberta.