rate limiting
the stereomood.com API only allows clients to make a limited number of calls in a given hour.
the default rate limit for calls to the REST API is 100 requests per hour. the REST API does “account and user authorization” based rate limiting.
rate limiting only applies to methods that request information with the HTTP GET command and use OAuth. API methods that use HTTP POST to submit data to stereomood.com do not affect rate limits.
your application should recognize it is being rate-limited by the REST API if it receives begins to receive HTTP 400 response codes. it is best practice for applications to monitor their current rate limit status and dynamically throttle requests if necessary. the REST API offers an HTTP response headers included in all REST API responses which count against the rate limit:
- X-RateLimit-Limit: current limit in effect
- X-RateLimit-Remaining: hits remaining before you are rate limited
- X-RateLimit-Reset: current rate limiting period ends in epoch time
- X-RateLimit-CurrentTime: current epoch time
Last edited by Stereomood Tech Team, March 29, 2010
