PlayElapseRequest

Body for POST /play/{play_id}/elapse, the periodic heartbeat that reports how far into a play the listener has got.

client_idstring

The client that owns the play. Required, but may instead arrive as a cid cookie or a client_id query parameter — see Identifying a client. Values longer than 23 characters are silently truncated.

Possible values: <= 23 characters

secondsnumberrequired

Current playback position, in seconds from the start of the file.

totalnumber

Total seconds of this file the listener has actually heard, which can differ from seconds when they have seeked around.

PlayElapseRequest

{
  "client_id": "string",
  "seconds": 0,
  "total": 0
}