USMARK

Portal do desenvolvedor

API pública e somente leitura do catálogo da loja USMARK: produtos, preços, variações, categorias, cores e tamanhos.

Comece por aqui

• Especificação OpenAPI 3.1 (JSON)
• Guia para agentes (llms.txt)
• Manifesto de descoberta (ARD)
• Procedimento de consulta do catálogo
• Sitemap

Primeira consulta

Busque produtos com uma requisição GET, sem chave nem login:

curl --get 'https://usmark.com.br/api/usm/pub/products' \
  --data-urlencode 'search=camiseta básica' \
  --data-urlencode 'page=1'

Use --data-urlencode para codificar espaços, acentos e outros caracteres nos parâmetros. Para filtrar por categoria, consulte /api/usm/pub/categories e envie o slug retornado em categorySlug. colorId e sizeId vêm de /api/usm/pub/colors e /api/usm/pub/sizes. featured=true, isNew=true e isOffer=true ativam os filtros correspondentes; sort aceita price_asc ou price_desc. A listagem retorna 24 produtos por página: avance page até cobrir total.

Endpoints públicos

• GET /api/usm/pub/products: Lista paginada (24 por página) dos produtos à venda. Filtros: search, categorySlug, colorId, sizeId, featured, isNew, isOffer, sort, page.
• GET /api/usm/pub/products/{slug}: Detalhe do produto com variações (cor, tamanho, estoque), fotos e categorias.
• GET /api/usm/pub/products/{slug}/related: Prioriza produtos das mesmas categorias e completa com outros destaques ou produtos recentes (parâmetro limit, até 20).
• GET /api/usm/pub/categories: Categorias com produto em estoque (árvore por parentId).
• GET /api/usm/pub/colors: Cores com produto em estoque.
• GET /api/usm/pub/sizes: Todos os tamanhos cadastrados, sem filtro de estoque, em ordem de exibição e nome.

Regras

• Sem chave e sem login: todos os endpoints acima são GET públicos.
• Preços em reais (BRL). Preço e estoque mudam: consulte na hora de responder e não guarde por muito tempo.
• Erros vêm em JSON com status, código estável (code), mensagem e o que fazer (hint).
• Há limite de requisições por IP. Ao receber 429 (code rate_limited), espere alguns segundos e repita.
• Criar pedido e pagar exigem o comprador no fluxo da loja e não fazem parte da API pública.

Formato de erro

{
  "error": {
    "status": 404,
    "code": "not_found",
    "message": "Produto não encontrado",
    "hint": "Use um slug retornado por /api/usm/pub/products.",
    "docs": "/openapi.json"
  },
  "message": "Produto não encontrado"
}

Atendimento: fale com a loja.