Sua primeira chamada em 5 minutos.

Cadastre-se com Google ou e-mail. Você entra em modo trial por 30 dias com acesso total à API, sem cartão de crédito.

Já tem conta? Pule para o passo 2.

No painel do seu estabelecimento, vá até as configurações e crie uma chave secreta (sk_live_). Ela será exibida apenas uma vez — copie e guarde.

Registre o primeiro usuário na sua base. Troque YOUR_SLUG pelo slug do seu estabelecimento e YOUR_KEY pela sk_live_ que você gerou.

curl -X POST \
  https://YOUR_SLUG.experi.com.br/api/v1/users \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "user_001",
    "name": "Maria Silva",
    "email": "maria@example.com"
  }'

Envie uma ação do usuário. A engine processa tudo atomicamente: desafios, badges, pontos e webhooks.

curl -X POST \
  https://YOUR_SLUG.experi.com.br/api/v1/actions/track \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_001",
    "action": "purchase_completed",
    "metadata": { "amount": 49.90 }
  }'

{
  "ok": true,
  "summary": {
    "challenges_completed": 2,
    "badges_granted": ["first_purchase"],
    "points_added": 150,
    "tier_promoted": "silver",
    "webhooks_dispatched": 3
  }
}

Se preferir JavaScript/TypeScript, use fetch ao invés de curl. O mesmo endpoint, a mesma resposta.

const res = await fetch(
  "https://YOUR_SLUG.experi.com.br/api/v1/actions/track",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      userId: "user_001",
      action: "purchase_completed",
      metadata: { amount: 49.90 },
    }),
  }
);

const data = await res.json();
console.log(data.summary);

Você acabou de rastrear sua primeira ação. Agora explore badges, recompensas, leaderboards e webhooks.