Référence API

Lire les réactions

Compte les réactions d’un article publié et les choix du visiteur sans retourner les identités des autres.

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

Modèle d’accès

Modèle d’accès: Accès public avec validation
Disponibilité documentée: Implémenté dans le code

La disponibilité est vérifiée dans le code, pas garantie en production.

Paramètres

Nom	Type	Validation
`slug`Obligatoire Identifiant d’URL pour la campagne ou l’article publié existant.	`string`	Validation : Segment URL public.
`visitorId`Facultatif Identité de visiteur utilisée pour lire ou modifier sa réaction à l’article.	`string`	Validation : Identité du visiteur.
`profileToken`Facultatif Jeton d’un profil communautaire vérifié existant ; cet endpoint ne crée pas cette identité.	`string`	Validation : Profil communautaire existant et vérifié.

Requête

Les exemples décrivent le contrat et ne sont pas exécutés. Utilisez des données de test autorisées ; ne saisissez jamais de secret réel ici.

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

http

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

Réponse

Réponse de succès · HTTP 200

json

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

Réponse d’erreur · HTTP 400

json

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

Validation, permissions, données indisponibles et pannes utilisent le statut HTTP et l’erreur du gestionnaire.

Limites et tentatives

Limite serveur par défaut : 100 requêtes par IP sur 60 secondes. Des contrôles spécifiques s’appliquent.

Compatibilité du code

Les opérations autorisées nécessitent des tests propres au compte.

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