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

The play was invalidated.

400

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.).

401

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"

404

missingObject (code 17) — no such play.

429

The server judged the rate of requests from these credentials to be excessive and is refusing them for a time. The block lasts 30 seconds from the request that tripped it. Requests made during the block are refused and do not extend it.

The threshold is not published, and is not part of this contract. The threshold is also tuned from time to time.

The response carries a Retry-After header giving whole seconds until the block clears. Wait at least that long. It says when to come back, not what rate to aim for, and retrying sooner simply meets the block again.

This exists to stop abuse, and a well-behaved client should not reach it; if yours does, the fix is to reduce your request rate rather than to retry on a timer. If you believe your application needs a rate that trips it, contact Feed.fm rather than working around it.

default

An error occurred.