Pular para o conteúdo principal
POST
Create product

📌 Endpoint

POST /stores/{storeId}/products Cria um novo produto na loja.

🔐 Autenticação

  • Rota privada.
  • Requer header Authorization com sua API key e plano ativo.

🧾 Parâmetros de rota


🧍 Body (JSON)


✅ Exemplo de requisição


Snippet padrão (cURL)

Use o exemplo cURL da seção Exemplo de requisição acima como snippet oficial.

📦 Resposta de sucesso (200)


⚠️ Possíveis erros

  • 400 INVALID_DATA → body ou storeId inválido
  • 400 INVALID_DATA_NAME_MIN → name ausente ou com menos de 3 caracteres
  • 400 INVALID_DATA_NAME_MAX → name com mais de 32 caracteres
  • 400 INVALID_DATA_IMAGE → image com mais de 512 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MIN → description com menos de 12 caracteres
  • 400 INVALID_DATA_DESCRIPTION_MAX → description com mais de 256 caracteres
  • 400 INVALID_DATA_DELIVERY → delivery ausente ou diferente de DIGITAL/PHYSICAL
  • 400 INVALID_DATA_PRICE → price ausente ou fora do intervalo 0.5 a 9999
  • 400 INVALID_DATA_STOCK → stock fora do intervalo -1 a 9999
  • 400 INVALID_DATA_CATEGORY_ID → algum item em categoryIds vazio ou com mais de 50 caracteres
  • 400 RELATION_NOT_FOUND → uma ou mais categorias em categoryIds não existem na loja
  • 400 NAME_ALREADY_EXISTS → já existe produto com esse nome
  • 401 API_KEY_NOT_PROVIDED → header Authorization não enviado (ou TOKEN_NOT_PROVIDED via Bearer)
  • 401 INVALID_API_KEY → API Key inválida (ou INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED via Bearer)
  • 403 USER_DISABLED → usuário desativado ou excluído
  • 403 NO_ACTIVE_SUBSCRIPTION → plano inativo ou expirado (ou PENDING_2FA via Bearer)
  • 403 PRODUCT_LIMIT_REACHED → limite de produtos do plano atingido
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 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

Autorizações

Authorization
string
header
padrão:YOUR_API_KEY_HERE
obrigatório

Parâmetros de caminho

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

Corpo

application/json

Product details (name, price, stock, categories).

Fields documented on the reference page.

Resposta

Create product.

code
string
obrigatório
Exemplo:

"SUCCESS"

product
object
obrigatório

Store product.