Saltar al contenido

Lista os níveis da comunidade

GET/api/gamification/levels

Auth
Requiere token
Quién puede:
owner
admin
Clave de API:
gamification:read
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Os níveis do Engajamento da comunidade do `X-CommunityId`, do primeiro ao último: `level` (o número, 1 a N), `name`, `minPoints`, `maxPoints` (null no último), `imageUrl` e `id`. Só owner e admin.

A comunidade que nunca mexeu nos níveis tem as 9 faixas padrão (0, 100, 300, 600, 1.000, 2.000, 3.500, 6.000 e 10.000 pontos), com os nomes de sempre ("Iniciante" a "Lenda") no idioma do `Accept-Language`. A primeira leitura grava essas faixas na comunidade, para que tenham `id` (o filtro do gatilho "Subiu de nível" e a condição "Nível é pelo menos" apontam para ele). `defaultName: true` diz que o nome ainda é o padrão traduzido. Cada nível traz também `requirements` (`actionType`, `minCount`, `spaceId`, `actionActive`: false quando a ação está desligada nas regras de pontos e não está contando). A resposta traz `limits`, `eligibleActions` (as ações que um requisito aceita, se estão ligadas e se acontecem num espaço), `timeZone` e `rule` (o texto da regra no idioma do `Accept-Language`, para o editor mostrar).

**A regra (David, 2026-11-01):** o nível exige os pontos mínimos (o total na comunidade, todas as seções) e os requisitos de atividade da semana (segunda 00:00 a domingo 23:59 no fuso da comunidade). Sobe na hora, pela semana atual; continua no nível pela semana anterior completa (ou pela atual); quem não cumpriu desce na segunda às 00:00; tirar pontos faz descer na hora. O nível de cada pessoa fica gravado.

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200Os níveis e os limites da edição.
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
403Autenticado, mas sem permissão para esta operação.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/gamification/levels" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"