Saltar al contenido

Painel de gestão das 1:1s

GET/api/one-on-ones/dashboard

Auth
Requiere token
Clave de API:
No acepta clave de API
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.

O painel "Gestão" de um espaço de 1:1 já agregado no servidor: indicadores com a comparação ao período anterior, 1:1s feitas por semana (por mês quando o intervalo passa de 6 meses), adesão por líder e por time e a tabela dos pares. Só números e datas: nunca pauta, nota ou texto de combinado.

Acesso igual ao da adesão: owner e admin veem a comunidade (`scope: community`); quem lidera alguém vê a própria árvore, os seus pares e os de todos os líderes abaixo (`scope: subtree`); quem não lidera ninguém: 403 `adherenceDenied`; sessão de suporte: 403.

Um par é um líder e um liderado com pelo menos uma 1:1 (registrada ou da série), mais todo par direto do organograma que nunca se reuniu. O time do par é o grupo principal do liderado. Regras: - 1:1 feita: reunião concluída até o fim do dia de hoje no fuso da comunidade, contada no dia em que aconteceu; uma concluída com data futura (dado antigo) é a próxima, nunca a última; - adesão: pares diretos com ao menos uma 1:1 no período, sobre todos os pares diretos; - status do par: `late` (atrasado) passada a cadência da série aberta (sem série, mensal) mais 3 dias, `never` sem nenhuma 1:1, `onTrack` em dia, `history` quando deixou de ser par direto; - tempo médio: dias entre 1:1s seguidas do mesmo par, a mais recente dentro do período; - combinados abertos e vencidos: hoje; no período anterior, os abertos no último dia dele (pela criação e conclusão de cada combinado).

`period=all` (o padrão) começa na primeira 1:1 do escopo e não tem comparação (`previous` nulo). `leaderId` e `teamId` recortam todos os números; `filters` lista os líderes e os times do escopo inteiro.

Parámetros

NombreDóndeTipoDescripción
periodopcionalqueryall | 30 | 90 | quarterDesde sempre, últimos 30 ou 90 dias, ou o trimestre corrente.
leaderIdopcionalquerystring (uuid)Só os pares deste líder.
teamIdopcionalquerystring (uuid)Só os pares cujo liderado é deste time.
spaceIdopcionalquerystring (uuid)Só as 1:1s deste espaço (os pares que nunca se reuniram entram sempre).

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
200O painel.
400Requisição inválida — falha de validaçã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.
404Recurso não encontrado.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/one-on-ones/dashboard" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"