Docs
APIReferênciaClientes

Criar cliente

Cadastra um cliente com e-mail e, se quiser, identidades de jogo.

Permissão da chave: Clientes › 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
email?string
Formatoemail
name?string
Tamanho1 <= length <= 120
taxId?string
Padrão (regex)^(\d{11}|\d{14})$
phone?string
Padrão (regex)^\+?\d{10,15}$

Corpo da resposta

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

Benefícios do cliente GET

Benefícios ativos e encerrados do cliente (ranks, assinaturas, itens). **Permissão da chave:** Clientes › ler.

Listar clientes GET

Lista os clientes da loja, com busca por e-mail ou nick. **Permissão da chave:** Clientes › ler.