Referência API

Ler reações

Conta reações do artigo publicado e escolhas atuais sem devolver identidades alheias.

GEThttps://api.sparkglim.net/api/public/blog/:slug/reactions

Modelo de acesso

Modelo de acesso: Acesso público com validação
Disponibilidade documentada: Implementado no código

Disponibilidade verificada no código, sem garantia de produção.

Parâmetros

Nome	Tipo	Validação
`slug`Obrigatório Identificador de URL da campanha ou artigo publicado existente.	`string`	Validação: Identificador URL público.
`visitorId`Opcional Identidade do visitante usada para consultar ou alternar a sua reação.	`string`	Validação: Identidade do visitante.
`profileToken`Opcional Token de perfil comunitário verificado existente; este endpoint não cria identidade.	`string`	Validação: Perfil de comunidade existente e verificado.

Pedido

Os exemplos descrevem o contrato e não são executados. Use registos de teste autorizados; nunca cole segredos reais aqui.

GET /api/public/blog/:slug/reactions

http

GET /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net

Resposta

Resposta de sucesso · HTTP 200

json

{
  "success": true,
  "data": {
    "counts": {
      "like": 0,
      "love": 0,
      "insightful": 0,
      "celebrate": 0,
      "clap": 0
    },
    "mine": []
  }
}

Resposta de erro · HTTP 400

json

{
  "success": false,
  "error": "<ERROR_MESSAGE>"
}

Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.

Limites e novas tentativas

Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.

Compatibilidade do código

As operações autorizadas exigem testes específicos da conta.

server/src/api/router.ts
server/src/api/routes/public.ts