Referência de API

A API pública do Rafobase permite integrar seu frontend ou sistemas externos ao programa de indicação e creators.

Autenticação

Todas as requisições devem incluir o header X-API-Key com sua chave de API:

curl https://api.rafobase.com/api/v1/member/me?email=user@example.com \
  -H "X-API-Key: SUA_API_KEY"

Nunca exponha sua API Key no frontend. Use-a apenas em chamadas servidor-para-servidor.

https://api.rafobase.com/api/v1

Busca um membro existente ou cria automaticamente (quando autoCreate=true).

Parâmetro	Tipo	Descrição
`email`	string	Email do membro (obrigatório)
`name`	string	Nome do membro
`externalId`	string	ID externo (do seu sistema)
`autoCreate`	bool	Se `true`, cria o membro caso não exista

curl "https://api.rafobase.com/api/v1/member/me?email=joao@example.com&name=Jo%C3%A3o&autoCreate=true" \
  -H "X-API-Key: SUA_API_KEY"

Lista as indicações feitas pelo membro autenticado.

Parâmetro	Tipo	Descrição
`email`	string	Email do membro

Consulta o saldo da carteira de um membro.

Retorna: totalEarned, totalRedeemed, available, pending, cancelled.

Retorna o histórico de transações da carteira.

Solicita o resgate do saldo disponível.

Retorna o perfil público de um creator pelo token.

Lista os tiers de comissão configurados para o creator.

Retorna o histórico de vendas atribuídas ao creator.

Todas as respostas de erro seguem o formato:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Member not found"
  }
}

Códigos HTTP comuns:

Para a especificação completa com schemas de request/response, consulte o endpoint OpenAPI:

GET https://api.rafobase.com/api/v1/openapi.json