Docs

Start here

Count a view

POST/v1/community/publications/{id}/viewson https://api.auray.ai/v1

Count one view of a shown work: once a day per visitor, and nobody who viewed is kept — the mark is a salted one-way digest deleted with its day.

Count one view of a shown work: once a day per visitor, and nobody who viewed is kept — the mark is a salted one-way digest deleted with its day. Takes no key; a key that holds community:write is counted by its account, and an author viewing their own work is never counted. A view that cannot be attributed answers counted: false.

#Authentication

No key needed: the public pages count their readers through the landing. A key that holds community:write is counted by its account.

#Request

#Path parameters

NameTypeRequiredDescription
idstringyes

#Example request

curl -X POST https://api.auray.ai/v1/community/publications/3f0c8a52-6a1d-4e8b-9c2d-7e5f4a3b2c1d/views

#Responses

#200 OK

OK.

FieldTypeRequiredDefaultDescription
objectstringyes—One of "view".
publication_idstringyes—
countedbooleanyes—False when this visitor was counted already today.
request_idstringno—Mirrored in the X-Request-Id header.

Headers:

HeaderDescription
RateLimit-LimitBurst capacity.
RateLimit-Remaining
RateLimit-ResetSeconds until refill.
X-RateLimit-Limit
X-RateLimit-Remaining
X-RateLimit-ResetUnix seconds. The X- spelling is what client libraries read.
X-Request-Id

#401 Unauthorized

#403 Forbidden

#404 Not Found

#429 Too Many Requests

#503 Service Unavailable

#Status codes

StatusMeaning
200OK.
401Unauthorized
403Forbidden
404Not Found
429Too Many Requests
503Service Unavailable

Every refusal names its code, and every code is explained at Errors.

Start typing to search every page of the documentation.

Up arrow Down arrow to moveEnter to openEscape to close