Para desenvolvedores e agentes

Portal do desenvolvedor

O site da AIQIA é legível por máquinas. Esta página documenta os endpoints públicos, a API de chat e as convenções que agentes de IA podem usar para se integrar com a AIQIA.

Endpoints machine-readable

Todos os endpoints abaixo são públicos e não exigem chave de API.

  • /llms.txt — Resumo do site em Markdown para LLMs, com instruções de quando usar a AIQIA (padrão llmstxt.org).
  • /openapi.json — Especificação OpenAPI 3.1 da API pública.
  • /sitemap.xml — Sitemap XML com todas as páginas indexáveis.
  • /robots.txt — Regras de crawling; agentes de IA são bem-vindos.

Páginas em Markdown

Toda página do site também é servida como text/markdown via negociação de conteúdo: envie o header Accept: text/markdown para qualquer URL e receba a versão Markdown. As respostas incluem Vary: Accept.

curl -H "Accept: text/markdown" https://www.aiqia.com.br/solutions/flashtms

API de chat

O endpoint POST /api/chat responde perguntas sobre logística, fiscal e os produtos AIQIA em linguagem natural. A resposta é um stream de texto puro. Sem autenticação; limites de 24 mensagens por chamada e 4.000 caracteres por mensagem.

curl -X POST https://www.aiqia.com.br/api/chat \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"O que o FlashTMS faz?"}]}'

Formato de erros

Erros da API são sempre JSON estruturado, com código estável, mensagem e dica de resolução:

{
  "error": {
    "code": "invalid_json",
    "message": "Payload inválido.",
    "hint": "Envie um corpo JSON no formato descrito em /openapi.json."
  }
}

Chaves de API e integrações

Os endpoints públicos não exigem chave. Para integrações com os produtos AIQIA (TMS, WMS, roteirização, APIs fiscais), ambiente de testes e credenciais, fale com nosso time comercial.

Falar com o time comercial
Desenvolvedores | AIQIA