API reference
Toggle article reaction
Toggles or changes one reaction for the supplied existing visitor or verified community profile on a published article.
https://api.sparkglim.net/api/public/blog/:slug/reactionsAccess model
- Access model
- Public access with validation
- Documented availability
- Implemented in source
Availability is verified from source, not a live production guarantee.
Parameters
| Name | Type | Validation |
|---|---|---|
slugRequiredURL-friendly identifier for the existing campaign or published article. | string | Validation: public slug. |
Request
| Name | Type | Validation |
|---|---|---|
typeRequiredSupported resource kind, reaction kind or discovery campaign filter specified by this endpoint. | enum | Validation: like | love | insightful | celebrate | clap. |
visitorIdRequiredExisting visitor identity used to retrieve or toggle that visitor’s article reaction. | string | Validation: 6–80. |
profileTokenOptionalToken of an existing verified community profile; this endpoint does not create that identity. | string | Validation: existing verified community profile. |
Request
Examples describe the contract and are not executed. Use authorized test records; never paste a real secret into these pages.
POST /api/public/blog/example-campaign/reactions HTTP/1.1
Host: api.sparkglim.net
Content-Type: application/json
{
"type": "like",
"visitorId": "example_visitor_0001"
}Response
{
"success": true,
"reacted": true
}{
"success": false,
"error": "<ERROR_MESSAGE>"
}Validation, permissions, unavailable records and temporary service failures use the handler’s HTTP status and error payload.
Limits & retries
Default Server limit: 100 requests per IP per 60 seconds. Resource-specific controls also apply.
Source compatibility
Authorized operations require account-specific testing.
server/src/api/router.tsserver/src/api/routes/public.ts