Report that a play finished playing.
POST/play/:play_id/complete
Call this when the song reaches its end. It closes out the play and finalizes the reported listen duration.
Completing a play that was already skipped or invalidated fails with
playbackComplete (code 21). Completing a play that was already
completed is a no-op: it returns 200 with success: true and leaves
the stored play untouched, so a client that retries a lost complete
response does not need to treat the second call specially.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- default
The play was marked complete.
missingParameter (code 16) — no client_id was supplied, or the
play id in the path is missing or non-numeric (Invalid or missing play id.).
Credentials were missing or invalid. The response carries
WWW-Authenticate: Basic realm="Feed.fm".
Response Headers
The authentication challenge. Always Basic realm="Feed.fm".
Basic realm="Feed.fm"playbackComplete (code 21) — this play was already skipped or
invalidated. Note that a repeated complete is not an error; it
returns 200.
missingObject (code 17) — no such play.
An error occurred.