Receitas

Missões, check-in e roleta na sua tela

Listar missões, resgatar, fazer check-in e girar a roleta pelo servidor.

Missões

bash

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

Cada missão traz title, progress, target, status (in_progress, completed, claimed), claim (auto ou manual), rewardLabel e resetsAt. Missão manual completa: POST /v1/me/missions/{id}/claim (erros 409 not_completed e 409 already_claimed).

Check-in

GET /v1/me/checkin devolve state (canClaim, streak, days[] com claimed/available/locked/missed, nextDayAt) e o calendário de prêmios. POST /v1/me/checkin faz o check-in do dia (409 already_claimed se já fez).

Roleta

O servidor sorteia: a sua tela só anima até a fatia que voltar. Mande um spinId único por giro (8 a 64 caracteres, letras, números, - e _): repetir o mesmo spinId devolve o mesmo resultado.

bash

curl -X POST https://api.iclubing.com/v1/me/wheel/spin \
  -H "Authorization: Bearer $ICLUBING_KEY" -H "X-Participant: user_123" \
  -H "Content-Type: application/json" -d '{ "spinId": "giro-2026-09-30-a1b2" }'

A resposta traz index e sliceId (onde parar), label, reward, spinsLeft, nextSpinAt e os effects. Sem giros: 409 no_spins. Prêmio de giros grátis chega como entrega.