The NetStorage API imposes rate-limiting constraints and exceeding these limits results in a 429 error response. Consider this especially when calling successive operations as part of a loop. These response headers provide rate limit information:

Limit                                 

Default value

Description

X-RateLimit-Limit

50

Maximum number of requests per minute.

X-RateLimit-Remaining

Variable

Number of remaining requests allowed during the current rate limit period.

When this becomes 0, you get a 429 error the next time you make an API call.

This gradually increases and becomes equal to X-RateLimit-Limit if you make no API calls after receiving a 429 error.

X-RateLimit-Next

Variable

Indicates when the client may issue another request after having exhausted the number of allowed requests for the current rate limit time period. Date and time is represented in the ISO 8601 standard format.