Référence API
Modifier une réaction
Bascule ou change une réaction du visiteur ou profil vérifié sur un article publié.
https://api.sparkglim.net/api/public/blog/:slug/reactionsModè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 |
|---|---|---|
slugObligatoireIdentifiant d’URL pour la campagne ou l’article publié existant. | string | Validation : Segment URL public. |
Requête
| Nom | Type | Validation |
|---|---|---|
typeObligatoireType de ressource, réaction ou filtre de campagne pris en charge ici. | enum | Validation : like | love | insightful | celebrate | clap. |
visitorIdObligatoireIdentité de visiteur utilisée pour lire ou modifier sa réaction à l’article. | string | Validation : 6–80. |
profileTokenFacultatifJeton 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.
POST /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json
{
"type": "like",
"visitorId": "example_visitor_0001"
}Réponse
{
"success": true,
"reacted": true
}{
"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.tsserver/src/api/routes/public.ts