Zum Inhalt springen

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

GET/api/public/community-summary

Auth
Öffentlich
X-CommunityId
X-CommunityId Sende die X-CommunityId der Community, in der die Operation stattfindet.
Die Beschreibungen der Endpoints stammen aus der API-Spezifikation und sind vorerst auf Portugiesisch. Die Oberfläche drumherum ist übersetzt.

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

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

Antworten

StatusBeschreibung
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.

curl-Beispiel

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