# Loja ASSIST — API, OpenAPI e CLI para desenvolvedores Fonte: https://loja.assist.com.br/developers 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 \, 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\. - [OpenAPI da Loja ASSIST]() - [Índice da API Loja ASSIST v1]() ## 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\. - [API versioning and deprecation policy — Loja ASSIST]() ## 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\. ```sh brew install jeanribas/assist/assist-loja ``` - [Instalação e comandos da CLI Loja ASSIST]() - [Publicação oficial Homebrew — Loja ASSIST]() ## Navegação - [Início]() - [Produtos]() ## Recursos ASSIST [Instruções para agentes](https://loja.assist.com.br/llms.txt) · [Sitemap](https://loja.assist.com.br/sitemap.xml)