Integrar

Headless (modo servidor)

Sua própria tela: puxe dados e aja em nome do participante pelo servidor.

Toda rota do participante (/v1/me/*) funciona de dois jeitos:

Quem chama	Autenticação
Navegador / app do participante	`Authorization: Bearer <token do participante>`
Seu servidor (modo servidor)	`Authorization: Bearer cf_live_…` + `X-Participant: <external_id>`

No modo servidor você não precisa de token: o seu backend pergunta e age em nome do participante e devolve para a sua tela só o que quiser mostrar.

bash

curl https://api.iclubing.com/v1/me/cashback \
  -H "Authorization: Bearer $ICLUBING_KEY" \
  -H "X-Participant: user_123"

O participante precisa existir no ambiente da chave (crie com um evento ou POST /v1/participants). Senão: 404 participant_not_found.
Sem o header: 400 participant_required.
O limite é o da chave (30 mil chamadas/min), não o do IP.

Rotas

Rota	Para quê
`GET /v1/me`	Perfil: XP, nível, elo, saldos, benefícios.
`GET /v1/me/ledger`	Extrato de moedas (`currency`, `limit`, `before`).
`GET /v1/me/cashback` · `POST /v1/me/cashback/claim`	Cashback: disponível e resgatar para o saldo. Receita: cashback próprio.
`GET /v1/me/checkin` · `POST /v1/me/checkin`	Calendário e check-in do dia.
`GET /v1/me/missions` · `POST /v1/me/missions/{id}/claim`	Missões e resgate manual.
`GET /v1/me/wheel` · `POST /v1/me/wheel/spin`	Roleta (o servidor sorteia).
`GET /v1/me/rewards` · `POST /v1/me/rewards/{id}/use`	Meus prêmios.
`POST /v1/me/redemptions`	Trocar moedas por um prêmio da loja.
`POST /v1/me/codes/redeem`	Ativar código promocional.
`GET /v1/me/tournaments` · `GET /v1/me/official-tournaments`	Torneios e rankings.
`GET /v1/me/referral`	Indique e ganhe: código, link e amigos.
`GET /v1/me/notifications` · `POST /v1/me/notifications/read`	Avisos do sino.
`GET /v1/me/config`	Configuração publicada (tema, textos, módulos) para desenhar a sua tela.

Quando uma ação gera um prêmio que o seu sistema credita, o efeito reward_granted traz o delivery_id: credite e confirme na mesma requisição, sem esperar o webhook. Detalhes de cada resposta na referência da API.