POST
/
hit
Increment and return hits for an id (POST)
curl --request POST \
  --url https://nums.advay.ca/hit
{
  "id": "<string>",
  "hits": 123,
  "source": "<string>"
}
Increment the counter for an id and return the updated value. Authentication
  • Send your secret via X-Auth-Token header or ?token= query.
Before you test
  • Use your own deployment URL (e.g., https://<project>.vercel.app) and your secret token from the server env (SECRET_TOKEN).
  • The public instance at https://nums.advay.ca is read-friendly; incrementing requires your own secret.
Example (self-hosted)
curl -H "X-Auth-Token: $SECRET_TOKEN" "https://<project>.vercel.app/hit?id=home"
Tip
  • Viewing counts does not require any token. See /count and /count.txt.

Headers

X-Auth-Token
string

Secret token for authentication (required unless token query provided)

Query Parameters

id
string

Counter id (default home)

token
string

Secret token (alternative to header)

url
string

Optional custom deployment URL (defaults to https://nums.advay.ca)

Response

200
application/json

OK

The response is of type object.