Discard a play that was never heard.
POST/play/:play_id/invalidate
Tells the server the play will not be played — the audio failed to load
or the format turned out to be unplayable. The play is removed from the
client's queue and is not reported as a listen, and the next POST /play returns a fresh song.
Use this rather than complete or skip whenever no audio reached the
listener. reason is free text recorded for diagnostics.
Request
Responses
- 200
- 400
- 401
- 404
- default
The play was invalidated.
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
WWW-Authenticate
The authentication challenge. Always Basic realm="Feed.fm".
Example:
Basic realm="Feed.fm"missingObject (code 17) — no such play.
An error occurred.