Saltar al contenido

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

GET/api/public/community-summary

Auth
Pública
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.

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.

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

Ejemplo con curl

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