Referência API

Alternar reação

Alterna ou muda reação do visitante ou perfil verificado no artigo publicado.

POSThttps://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.

Pedido

Nome	Tipo	Validação
`type`Obrigatório Tipo de recurso, reação ou filtro de campanha suportado aqui.	`enum`	Validação: like \| love \| insightful \| celebrate \| clap.
`visitorId`Obrigatório Identidade do visitante usada para consultar ou alternar a sua reação.	`string`	Validação: 6–80.
`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.

POST /api/public/blog/:slug/reactions

http

POST /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json

{
  "type": "like",
  "visitorId": "example_visitor_0001"
}

Resposta

Resposta de sucesso · HTTP 200

json

{
  "success": true,
  "reacted": true
}

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

Modelo de acesso

Parâmetros

Pedido

Pedido

Resposta

Limites e novas tentativas

Compatibilidade do código

Continuar a desenvolver