Vai al contenuto

Cursos, chamadas abertas e certificados indexáveis que um visitante vê

GET/api/public/community-summary

Auth
Pubblica
X-CommunityId
X-CommunityId Invia l’X-CommunityId della community in cui avviene l’operazione.
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

Sem login; a comunidade vem do `X-CommunityId`. Devolve, num só pedido, o que um visitante **deslogado** vê de três coisas, para o `/sitemap.xml` e o `/llms.txt` do app:

- `courses`: cursos publicados e aprovados de espaços de Cursos que o visitante abre; - `callsForPapers`: chamadas de trabalhos **abertas** agora (publicadas, `open`, dentro da janela de envio) de espaços de Chamada de trabalhos que o visitante abre; - `certificates`: certificados emitidos, não revogados nem substituídos, cujo titular ligou a indexação (a página pública de verificação). Nunca o nome, o e-mail ou outro dado do titular.

Comunidade que não recebe visitantes (`guestAccess` desligado, o padrão) devolve 200 com as três listas vazias, inclusive `certificates`: o certificado indexável continua na página pública de verificação, mas não é anunciado aqui.

Espaço com cadeado, oculto, só da equipe, por plano ou privado não entra: a regra é a mesma do menu para quem não entrou. Cada item traz `title`, `description` (uma linha, até 200 caracteres, ou `null`), `path` (caminho no endereço da comunidade) e `updatedAt`; a chamada traz também `closesAt`. Até 200 itens por lista, mais recentes primeiro. A resposta é guardada por até 5 minutos (no servidor e no `Cache-Control`). Limite de 120 leituras por minuto por IP (429 com `Retry-After`). Comunidade inexistente ou apagada: 404.

Header

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

Risposte

CodiceDescrizione
200As três listas (vazias quando a comunidade não recebe visitantes).
400Requisição inválida — falha de validação.
404Recurso não encontrado.
429Muitas leituras deste IP; tente de novo depois do `Retry-After`.
500Erro interno do servidor.

Esempio con curl

curl -X GET "https://api.memberfy.net/api/public/community-summary" \
  -H "X-CommunityId: $COMMUNITY_ID"