# USMARK

> Loja de camisetas e vestuário no atacado direto da fábrica.

## Quando usar

- Para encontrar camisetas e outros produtos pelo nome, faça GET em /api/usm/pub/products com o filtro search.
- Para descobrir as categorias e consultar os produtos de uma delas, faça GET em /api/usm/pub/categories e use o slug retornado como categorySlug em GET /api/usm/pub/products.
- Para consultar preços atuais, cores, tamanhos e disponibilidade de um produto, faça GET em /api/usm/pub/products/{slug}, usando o slug retornado na listagem.

Essas consultas são públicas e não precisam de chave nem de login. Consulte a especificação OpenAPI para os parâmetros e formatos das respostas.

## Navegação
- [Início](https://usmark.com.br/usmark): apresentação da loja.
- [Catálogo](https://usmark.com.br/usmark/loja): produtos disponíveis.
- [Perguntas frequentes](https://usmark.com.br/usmark/faq): consulte as regras atuais de compra.
- [Trocas e devoluções](https://usmark.com.br/usmark/trocas): política da loja.
- [Contato](https://usmark.com.br/usmark/contato): atendimento.
- [Sitemap](https://usmark.com.br/sitemap.xml): URLs de produtos, categorias e páginas públicas.

## Dados públicos para consulta
- [Especificação OpenAPI](https://usmark.com.br/openapi.json): API pública do catálogo em OpenAPI 3.1, com o formato de erro.
- [Portal do desenvolvedor](https://usmark.com.br/developers): endpoints, regras de uso e formato de erro.
- [Produtos em JSON](https://usmark.com.br/api/usm/pub/products): lista paginada com rows, total, page e pageSize. Use page=2 para a próxima página e search para buscar pelo nome.
- [Categorias em JSON](https://usmark.com.br/api/usm/pub/categories): categorias do catálogo.
- [Manifesto ARD](https://usmark.com.br/.well-known/ard.json): recursos públicos descritos para descoberta.
- [Guia de consulta do catálogo](https://usmark.com.br/usmark/agents/catalogo.md): procedimento de consulta para agentes.

O detalhe de um produto está em /api/usm/pub/products/{slug}; use o slug retornado na listagem. A página correspondente está em /usmark/produto/{slug}.
Os preços são em reais (BRL). Consulte os dados atuais; preços e disponibilidade podem mudar. Não presuma descontos, frete ou condições de pagamento.
As páginas públicas da loja (inclusive a raiz) respondem em Markdown quando a requisição envia Accept: text/markdown. Os erros dos seis endpoints de catálogo descritos em /openapi.json e /developers vêm em JSON com error.code, error.message e error.hint. Outros endpoints do site podem usar formatos diferentes.
Estes recursos são de leitura. A criação de pedidos e o pagamento exigem a interação e a autorização do comprador no fluxo da loja. O sistema interno e as contas de clientes não fazem parte deste catálogo.