Docs
APIReferênciaProdutos

Criar produto

Cria um produto com preço em centavos, imagem, descrição e regras de compra.

Permissão da chave: Catálogo › escrever.

Autenticação

bearer
headerAuthorizationBearer <chave de API>

Chave de API da loja (Painel › Integrações › Chaves de API)

Headers

Idempotency-Key?string

Chave única por operação (ex.: o id do pedido no seu sistema). Repetir a chamada com a mesma chave devolve a mesma resposta, sem duplicar.

Padrão (regex)^[A-Za-z0-9._:-]+$
Tamanho8 <= length <= 255
application/json
  1. body
name*string
Tamanho1 <= length <= 120
description*string
Tamanholength <= 5000
sku?string
Padrão (regex)^[A-Za-z0-9._-]{1,64}$
price*
compareAt?
imageUrl?string
Formatouri
icon?string
Tamanholength <= 60
gallery?array<>
Itensitems <= 10
videoUrl?string
Formatouri
tags?array<>
Itensitems <= 20
accessDays?number
Intervalo1 <= value <= 3650
categoryId?string
featured?boolean
listed?boolean
badge?string
Tamanho1 <= length <= 20
accentColor?string
Padrão (regex)^#[0-9a-fA-F]{6}$
visibleFrom?string
visibleUntil?string
requireLogin?boolean
limitTotal?number
Intervalo1 <= value <= 1000000
limitPerCustomer?number
Intervalo1 <= value <= 1000000
limitCountsExpired?boolean
singleQuantity?boolean
giftCardValue?
giftCardDays?number
Intervalo1 <= value <= 3650
acceptsGiftCard?boolean
giftable?boolean

Corpo da resposta

Exemplo de requisição
curl -X POST "https://api.rivoo.gg/v1/products" \  -H "Authorization: Bearer $RIVOO_API_KEY" \  -H "Idempotency-Key: pedido_123" \  -H "Content-Type: application/json" \  -d '{"name":"string","description":"string","price":{"amount":0}}'
Exemplo de resposta
Vazio