Docs
APIReferênciaCriadores

Criar criador

Cadastra um criador com código, desconto para o comprador e comissão.

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

Corpo da requisição

application/json
  1. body
name*string
Tamanho1 <= length <= 60
code*string
Padrão (regex)^[A-Z0-9_-]{3,32}$
commissionBps?number
Intervalo100 <= value <= 5000
discountBps?number
Intervalo0 <= value <= 5000
contact?string
Tamanho0 <= length <= 120
active?boolean

Corpo da resposta

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

Arquivar criador DELETE

Desativa o código do criador. **Permissão da chave:** Catálogo › escrever.

Listar criadores GET

Criadores de conteúdo com código de desconto e comissão. **Permissão da chave:** Catálogo › ler.