Record a play event from the embed iframe (unauthenticated)
FE-pinged on `play` / `ended` from `EmbedPlayerPage`. The token is the 10-char public-link token. No authentication — the token itself is the credential. The backend hard-codes `visibility: 'public'` for this route — there's intentionally no `visibility` field accepted on the body. Only recorded while the link is `active`: a missing or disabled link rejects with 404 (deliberately indistinguishable), an expired one with 410.
FE-pinged on play / ended from EmbedPlayerPage. The token is
the 10-char public-link token. No authentication — the token itself
is the credential. The backend hard-codes visibility: 'public' for
this route — there's intentionally no visibility field accepted on
the body. Only recorded while the link is active: a missing or
disabled link rejects with 404 (deliberately indistinguishable), an
expired one with 410.
Path Parameters
^[a-zA-Z0-9]{10}$Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/public-download/Ab3dEf9HiJ/access-activity" \ -H "Content-Type: application/json" \ -d '{ "eventType": "play_started" }'