Analytics

Record a privacy-bucketed page event.

Used by the web app and trusted clients to capture aggregate page demand. The public traffic API returns only rollups, never raw visitor keys, IPs, user agents, or referrers.

Inputs. No path or query fields are required. The request body schema lists accepted fields and required values.

Outputs. See each status below for its media type, schema and headers. A missing record or unavailable capability is not a successful empty result.

Errors. API JSON failures use the documented response schema. Read code, message and next; retry only when the response allows it. Auth, invalid input and missing records need a caller change.

Rate limits. Write and protocol operations can have separate route-specific limits. Read Retry-After and retry_after_s when present; do not infer a write allowance from the public read budget.

Example setup. This example is not executed by documentation checks. Review the operation and obtain any required user consent before sending it.

post/api/events/page

Request

  • Base URL: https://huggingbay.xyz
  • URL: https://huggingbay.xyz/api/events/page
  • Auth: none declared

Request body

pathstring
routestring
titlestring
referrerstring

Response

Event accepted or safely ignored when persistence is unavailable

okboolean required
recordedboolean required
trafficClassstring

Changes

No recorded changes to this operation across all 2 revisions of this API.