Skip to main content
POST
Criar produto

Criar Produto

Cadastra um novo produto no catálogo da empresa autenticada.

Comportamento atual

  • name e price são obrigatórios
  • quantity é opcional e, quando omitido, usa 0
  • o contrato atual aceita price >= 0
  • a resposta retorna id, name, price, quantity, description, image_url e created_at

Exemplo de resposta

Status comuns

  • 201 produto criado com sucesso
  • 401 API Key inválida ou revogada
  • 403 plano sem api_access
  • 422 header ou body inválidos
  • 429 limite global da API pública excedido

Headers

X-API-Key
string
required

Chave de API

Body

application/json

Criar produto.

name
string
required
Required string length: 1 - 255
price
number
required
Required range: x >= 0
description
string | null
quantity
integer
default:0
Required range: x >= 0

Response

Successful Response

Dados de um produto.

id
string
required
name
string
required
price
number
required
quantity
integer
required
created_at
string<date-time> | null
description
string | null
image_url
string | null