{"openapi":"3.1.0","info":{"title":"Catálogo público Apolônia Grade","version":"1.0.0","description":"API REST v1, versionada no caminho /v1. Os caminhos anteriores sem versão continuam como aliases da v1, sem encerramento programado. Mudanças incompatíveis terão nova versão maior. Somente produtos publicados; sem pedidos, clientes, pagamento, dados privados de estoque ou escrita."},"externalDocs":{"description":"Política de versionamento e descontinuação","url":"https://apoloniarosadodeserto.com.br/apps/catalogo/versioning"},"servers":[{"url":"https://apoloniarosadodeserto.com.br/apps/catalogo/v1","description":"Versão estável v1"}],"security":[],"paths":{"/products":{"get":{"operationId":"searchPublicProducts","summary":"Pesquisar produtos publicados","parameters":[{"name":"q","in":"query","description":"Texto simples, sem operadores de consulta.","schema":{"type":"string","maxLength":100}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":10}},{"name":"after","in":"query","description":"Cursor retornado na página anterior.","schema":{"type":"string","maxLength":1024}}],"responses":{"200":{"description":"Consulta pública atual. Confirme valores e entrega no checkout oficial.","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","required":["handle","title","description","availableForSale","onlineStoreUrl","priceRange"],"properties":{"handle":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"availableForSale":{"type":"boolean"},"onlineStoreUrl":{"type":"string","format":"uri"},"featuredImage":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"altText":{"type":["string","null"]}}},"priceRange":{"type":"object","properties":{"minVariantPrice":{"type":"object","required":["amount","currencyCode"],"properties":{"amount":{"type":"string"},"currencyCode":{"type":"string"}}},"maxVariantPrice":{"type":"object","required":["amount","currencyCode"],"properties":{"amount":{"type":"string"},"currencyCode":{"type":"string"}}}}}}}},"pageInfo":{"type":"object","properties":{"hasNextPage":{"type":"boolean"},"endCursor":{"type":["string","null"]}}},"readOnly":{"const":true},"source":{"type":"string"},"checkedAt":{"type":"string","format":"date-time"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Parâmetro inválido","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"404":{"description":"Produto ou rota não encontrado","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}},"text/markdown":{"schema":{"type":"string"},"example":"# 404 — Recurso não encontrado\n\nConsulte a documentação do catálogo e o sitemap da loja."}}},"405":{"description":"Somente GET e HEAD","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"502":{"description":"Falha temporária na origem","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"503":{"description":"Limite temporário da origem","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}}}}},"/products/{handle}":{"get":{"operationId":"getPublicProduct","summary":"Consultar um produto pelo identificador de sua URL","parameters":[{"name":"handle","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,199}$"}}],"responses":{"200":{"description":"Consulta pública atual. Confirme valores e entrega no checkout oficial.","content":{"application/json":{"schema":{"type":"object","properties":{"product":{"type":"object","required":["handle","title","description","availableForSale","onlineStoreUrl","priceRange"],"properties":{"handle":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"availableForSale":{"type":"boolean"},"onlineStoreUrl":{"type":"string","format":"uri"},"featuredImage":{"type":["object","null"],"properties":{"url":{"type":"string","format":"uri"},"altText":{"type":["string","null"]}}},"priceRange":{"type":"object","properties":{"minVariantPrice":{"type":"object","required":["amount","currencyCode"],"properties":{"amount":{"type":"string"},"currencyCode":{"type":"string"}}},"maxVariantPrice":{"type":"object","required":["amount","currencyCode"],"properties":{"amount":{"type":"string"},"currencyCode":{"type":"string"}}}}}}},"readOnly":{"const":true},"source":{"type":"string"},"checkedAt":{"type":"string","format":"date-time"}}}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Parâmetro inválido","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"404":{"description":"Produto ou rota não encontrado","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}},"text/markdown":{"schema":{"type":"string"},"example":"# 404 — Recurso não encontrado\n\nConsulte a documentação do catálogo e o sitemap da loja."}}},"405":{"description":"Somente GET e HEAD","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"502":{"description":"Falha temporária na origem","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}},"503":{"description":"Limite temporário da origem","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","resolution"],"properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"resolution":{"type":"string"}}}}}}}}}}}