Ir para o conteúdo
AUTROTEC

API v1.0.0

API pública e leitura por agentes

O catálogo da AUTROTEC em JSON, Markdown e OpenAPI. Sem cadastro, sem chave de acesso, somente leitura.

Esta página documenta as interfaces legíveis por máquina do site da AUTROTEC Sistemas Eletrônicos. Servem para integrações, catálogos de terceiros e assistentes de IA que precisem responder sobre os nossos serviços, produtos e marcas citando a página correspondente. English: public, read-only JSON API and Markdown representations of this website. No authentication required.

O essencial

  • URL base: https://autrotec.com
  • Especificação OpenAPI 3.1: /openapi.json (igual em /api/openapi.json)
  • Índice da API: /api/v1
  • Índice para agentes: /llms.txt
  • Autenticação: nenhuma. Todos os dados são públicos e já estão nas páginas do site.
  • Métodos: apenas GET, HEAD e OPTIONS. CORS liberado para qualquer origem.
  • Limite de uso: 120 pedidos por minuto por IP, anunciados nos cabeçalhos RateLimit-Policy e RateLimit. As respostas podem ser cacheadas por 5 minutos.
  • Preços: não estão na API — condições comerciais são informadas por cotação.
  • CLI: npx autrotec buscar "trena uti" (veja abaixo)
  • Catálogo de APIs (RFC 9727): /.well-known/api-catalog

Endpoints

EndpointoperationIdO que devolve
GET /api/v1getApiIndexÍndice da API
GET /api/v1/companygetCompanyDados da empresa
GET /api/v1/serviceslistServicesLista os serviços
GET /api/v1/services/{slug}getServiceDetalha um serviço
GET /api/v1/productslistProductsLista as categorias de produtos
GET /api/v1/products/{slug}getProductDetalha uma categoria de produtos
GET /api/v1/brandslistBrandsLista as marcas representadas
GET /api/v1/brands/{slug}getBrandDetalha uma marca
GET /api/v1/articleslistArticlesLista os artigos técnicos
GET /api/v1/articles/{slug}getArticleLê um artigo técnico
GET /api/v1/searchsearchCatalogBusca no catálogo

Exemplos

curl https://autrotec.com/api/v1/company
curl https://autrotec.com/api/v1/services
curl https://autrotec.com/api/v1/products/trena-uti
curl "https://autrotec.com/api/v1/search?q=calibra%C3%A7%C3%A3o&type=service,article&limit=5"

Erros

Todos os erros são JSON, com um code estável, uma mensagem legível e um hint com o próximo passo:

{
  "error": {
    "code": "not_found",
    "status": 404,
    "message": "Não existe serviço com o slug \"calibracao-de-gas\".",
    "hint": "Liste os slugs disponíveis em https://autrotec.com/api/v1/services.",
    "documentationUrl": "https://autrotec.com/desenvolvedores"
  }
}
codeHTTPQuando acontece
invalid_request400Parâmetro em falta ou fora do intervalo aceite.
not_found404Slug ou endpoint inexistente.
method_not_allowed405Qualquer método além de GET, HEAD e OPTIONS.
internal_error500Falha inesperada do servidor.

Limite de uso

Toda resposta traz a política e o estado da quota, no formato do draft do IETF, para o cliente se regular sozinho sem precisar levar um erro primeiro:

RateLimit-Policy: "default";q=120;w=60
RateLimit: "default";r=118;t=47
RateLimit-Limit: 120
RateLimit-Remaining: 118
RateLimit-Reset: 47

São 120 pedidos por minuto por IP. Acima disso a resposta é 429 com Retry-After em segundos e o mesmo corpo de erro em JSON. A contagem é feita por instância do servidor, então o limite efetivo é mais generoso do que o anunciado — trate os cabeçalhos como o valor de referência. Se precisar de mais do que isso de forma contínua, fale conosco: conteúdo em cache resolve a maioria dos casos.

Versões e descontinuação

  • A versão maior está no caminho (/api/v1) e a exata no cabeçalho API-Version (hoje 1.0.0).
  • Mudanças aditivas — campos e endpoints novos — entram sem aviso. Ignore os campos que não conhecer em vez de validar a resposta inteira.
  • Mudanças que quebram compatibilidade só entram numa nova versão de caminho (/api/v2). A versão antiga continua a responder.
  • Quando uma versão for descontinuada, todas as suas respostas passam a trazer Deprecation (RFC 9745) e Sunset (RFC 8594), com pelo menos 12 meses entre o anúncio e o desligamento.
  • Estado atual: versão corrente, sem data de desligamento anunciada.

CLI

O autrotec traz o mesmo catálogo para o terminal — útil para consultas rápidas e para agentes que preferem um comando a montar chamadas HTTP. Precisa de Node.js 20 ou superior.

npx autrotec buscar "trena uti"
npx autrotec servicos calibracao
npx autrotec empresa
npx autrotec produtos --json | jq '.data[].slug'
npx autrotec ler /blog/o-que-e-trena-uti

npm install -g autrotec   # para usar sem o npx

Todo comando aceita --json e escreve em stdout; o código de saída é 0 em sucesso e 1 em erro. O CLI só lê: nada nele envia dados para a AUTROTEC, e autrotec contato mostra os canais para falar com uma pessoa.

Páginas em Markdown

Qualquer página do site responde em Markdown a quem pedir, conforme o acceptmarkdown.com: envie o cabeçalho Accept: text/markdown ou acrescente .md ao caminho. A página inicial é /index.md.

curl -H "Accept: text/markdown" https://autrotec.com/servicos/calibracao
curl https://autrotec.com/marcas/riken-keiki.md

Caminhos inexistentes respondem 404 com um corpo em Markdown a indicar onde procurar. O /llms.txt lista todas as páginas e explica em que casos a AUTROTEC é a empresa certa; o /sitemap.xml traz as URLs em HTML.

Contato

Dúvidas, integrações ou pedidos de dados adicionais: autrotec@autrotec.com.br.