Loja ASSIST — API, OpenAPI e CLI para desenvolvedores
A Loja ASSIST Tecnologia oferece uma API pública e uma CLI oficial para consultar equipamentos de rede e infraestrutura de TI. Desenvolvedores e agentes podem buscar modelos, ler especificações publicadas e preparar listas para cotação. A API v1 é somente de leitura e não exige login, token nem chave. Ela não cria pedidos, não reserva estoque e não envia mensagens.
O contrato OpenAPI 3.1.1 está em https://loja.assist.com.br/openapi.json. Cada operação possui operationId único, descrição, parâmetros tipados e schemas de resposta. O índice está em GET /api/v1. Use GET /api/v1/products para pesquisar por q (nome ou SKU), brand e category. GET /api/v1/products/{slug} retorna o produto. GET /api/v1/brands e GET /api/v1/categories retornam os slugs das coleções ativas.
As coleções aceitam limit entre 1 e 100 (padrão 20) e offset entre 0 e 10000 (padrão 0). Os resultados são ordenados por nome e slug; siga nextOffset para continuar. q aceita de 1 a 120 caracteres. A busca trata sinais de porcentagem e sublinhado como texto literal. Parâmetros desconhecidos, repetidos ou fora dos limites recebem HTTP 400. Produtos ausentes e endpoints desconhecidos recebem 404. Outros métodos recebem 405; HEAD retorna os mesmos cabeçalhos de GET sem corpo.
As respostas de sucesso são application/json. Os erros usam application/problem+json conforme RFC 9457, com type, title, status, detail, instance, code e hint. Em HTTP 503, respeite Retry-After antes de repetir. Códigos estáveis incluem invalid_parameter, product_not_found, endpoint_not_found, method_not_allowed e catalog_unavailable. Mensagens não expõem consultas SQL ou credenciais. Preço null significa sob consulta; availability confirm_with_sales exige confirmação comercial.
Rate limit: a API de catálogo aceita 300 requisições por minuto UTC por IP e informa o saldo nos cabeçalhos RateLimit e RateLimit-Policy. HTTP 429 inclui Retry-After. Consulte a política de limites, versioning, deprecation e Sunset em https://loja.assist.com.br/api-policy.md. A v1 está ativa, sem data de encerramento anunciada. Mudanças incompatíveis exigem nova versão principal; futuras descontinuações serão anunciadas com orientação de migração.
A CLI assist-loja-cli requer Node.js 20 ou superior. Instale o pacote oficial com npm install -g https://loja.assist.com.br/cli/assist-loja-cli-1.0.0.tgz e execute assist-loja products --query synology --limit 5. Outros comandos são info, product <slug>, brands, categories e openapi. A saída é JSON em stdout; erros são JSON em stderr. O pacote não possui dependências ou scripts de instalação. O manifesto com hashes de integridade está em /cli/manifest.json e o guia em /cli/README.md.
A CLI oficial também está publicada no Homebrew: brew install jeanribas/assist/assist-loja. O tap ASSIST está em https://github.com/jeanribas/homebrew-assist e contém a fórmula, o hash de integridade e o teste de instalação. Esta opção não exige login npm. Consulte o guia em /cli/homebrew.md.
As páginas do site continuam disponíveis em HTML ou Markdown por Accept: text/markdown, com Vary: Accept, Accept-Encoding. Use llms.txt e sitemap.xml para descobrir as páginas. Endpoints públicos da API estão listados no OpenAPI; as APIs internas da aplicação, /admin e /auth continuam fora do contrato público. Não há API de pedidos nem servidor MCP. Os formulários mantêm a verificação de segurança. Não envie dados pessoais nem mensagens sem autorização do usuário. Atendimento da ASSIST: contato@assist.com.br e +55 48 3211-8451.
API Loja ASSIST — documentação e autenticação
A consulta ao catálogo é pública, somente de leitura e não requer chave ou token. Comece pelo índice da API v1 e pelo contrato OpenAPI. As APIs internas de autenticação da loja não fazem parte desta integração.
API versioning and deprecation policy
A política de versionamento e descontinuação da Loja ASSIST documenta as mudanças compatíveis, a criação de novas versões principais e os avisos Deprecation e Sunset. A v1 está ativa, sem encerramento anunciado.
CLI oficial Loja ASSIST — Homebrew
Instale a CLI oficial pelo tap Homebrew da ASSIST para consultar o catálogo e receber JSON pelo terminal. Não é necessário login npm.
brew install jeanribas/assist/assist-loja