Pular para o conteúdo principal
GET
Get product by ID

📌 Endpoint

GET /stores/{storeId}/products/{productId} Retorna um produto específico da loja.

🔐 Autenticação & Validações

  • Rota pública para consulta (não utiliza autenticação).
  • ⚠️ Validação de negócio: O dono da loja deve ter um plano ativo.
    • Se o plano está inativo/expirado, retorna 403 NO_ACTIVE_SUBSCRIPTION.

🧾 Parâmetros de rota


✅ Exemplo de requisição


Snippet padrao (cURL)

Use o exemplo cURL da secao Exemplo de requisicao acima como snippet oficial.

📦 Resposta de sucesso (200)


⚠️ Possíveis erros

  • 400 INVALID_DATA → parâmetros inválidos (storeId ou productId vazio ou > 50 caracteres)
  • 401 UNAUTHENTICATED → não foi possível identificar o usuário da assinatura
  • 403 NO_ACTIVE_SUBSCRIPTION → plano inativo ou expirado
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 404 PRODUCT_NOT_FOUND → produto não encontrado (inclusive quando productId possui até 50 caracteres, mas não é um UUID válido)
  • 429 RATE_LIMIT_EXCEEDED → limite de requisições por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → erro interno
  • 503 SERVICE_UNAVAILABLE → serviço ou banco de dados indisponível

Parâmetros de caminho

storeId
string
obrigatório
Required string length: 1 - 50
productId
string
obrigatório
Required string length: 1 - 50

Resposta

Get product by ID.

code
string
obrigatório
Exemplo:

"PRODUCT_FETCHED"

product
object
obrigatório

Store product.