InputBuffer.io

Test Configuration

For security, tokens are stored locally in your browser.

Reactions

Thumbs-up / thumbs-down votes on targets

POST/api/v0/reactions

Submit a reaction

Record a thumbs-up (1) or thumbs-down (-1) reaction against a target surface.

Target resolution — supply target.type + target.metadata. The target is found or auto-created using the same dedupe-key logic as input creation.

Dedupe — the API prevents double-voting: - If user_id is provided it is hashed (SHA-256) and used for strict all-time dedupe: one reaction per user per target, forever. - If user_id is omitted, the caller's IP address is hashed and used for a 24-hour time-window dedupe: one reaction per IP per target per day. This is best-effort and may block users sharing a NAT or proxy.

Duplicate submissions return a 201 with the same response shape as a new reaction.

Parameters
Request Body*
target*(object)

Target to react to. Provide type + metadata — the target is found or auto-created using the same dedupe-key logic as input creation.

HTTP method (e.g. GET, POST).

API endpoint path.

Hostname of the API (e.g. api.example.com).

API version string (e.g. v1).

1 for thumbs-up, -1 for thumbs-down.

Optional identifier for the end user submitting the reaction (e.g. your internal user ID or account email). Hashed with SHA-256 before storage — the raw value is never persisted. Used for strict all-time dedupe: one reaction per user per target. If omitted, dedupe falls back to a 24-hour IP-address window.

Response
201Reaction recorded
data*object
id*string

Short ID derived from a UUID (short-uuid)

target_id*string

Short ID derived from a UUID (short-uuid)

reaction_value*"1" | "-1"

1 for thumbs-up, -1 for thumbs-down.

created_at*string (date-time)

ISO 8601 timestamp when the reaction was recorded.

400Validation error (missing or invalid fields)

No response body

401Missing or invalid API token

No response body

404Target not found

No response body

https://inputbuffer.io/api/v0/reactions
{
  "target": {
    "type": "rest_endpoint"
  },
  "reaction_value": null
}
GET/api/v0/targets/{targetId}/reactions/summary

Get reaction summary for a target

Returns all-time totals and a 30-day daily breakdown of thumbs-up / thumbs-down reactions for a specific target. Requires a full_access token — widget tokens are not permitted.

Parameters

Short ID of the target.

Response
200Reaction summary
data*object
target_id*string

Short ID derived from a UUID (short-uuid)

total_up*integer

Total thumbs-up reactions of all time.

total_down*integer

Total thumbs-down reactions of all time.

net_score*integer

total_up minus total_down.

daily*array

Per-day up/down counts for the past 30 days.

day*string (date)
up*integer
down*integer
401Missing or invalid API token

No response body

403Widget tokens are not permitted to access reaction summaries

No response body

404Target not found

No response body

https://inputbuffer.io/api/v0/targets//reactions/summary