Skip to documentation
SparkGlimSparkGlim Developer
Search all documentation

Try a topic in your language or an exact API path.

    API reference

    Read article reactions

    Counts the supported reactions on a published article and identifies the current visitor’s selections without returning other visitor identities.

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

    Access model

    Access model
    Public access with validation
    Documented availability
    Implemented in source

    Availability is verified from source, not a live production guarantee.

    Parameters

    NameTypeValidation
    slugRequired

    URL-friendly identifier for the existing campaign or published article.

    stringValidation: public slug.
    visitorIdOptional

    Existing visitor identity used to retrieve or toggle that visitor’s article reaction.

    stringValidation: visitor identity.
    profileTokenOptional

    Token of an existing verified community profile; this endpoint does not create that identity.

    stringValidation: 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.

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

    Response

    Success response · HTTP 200
    json
    {
      "success": true,
      "data": {
        "counts": {
          "like": 0,
          "love": 0,
          "insightful": 0,
          "celebrate": 0,
          "clap": 0
        },
        "mine": []
      }
    }
    Error response · HTTP 400
    json
    {
      "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.ts
    • server/src/api/routes/public.ts