Channel API: rate limits

About this article

This article describes the rate-limiting guidelines that apply to the Channel API.

Table of contents

Introduction 

Request rate limits

View rate limits

Introduction

To ensure that ChannelEngine can continue serving its customers and partners efficiently and reliably, it is necessary to make use of rate limiting in the Channel API. The rate limits defined allow ChannelEngine's customers and partners to perform all calls required to conduct their business in a timely manner.

It is recommended that you make use of dynamic throttling and consider the limits and intervals communicated in the response headers.

Request rate limits

To request the rate limit for each endpoint:

1. Go to the Channel API reference for your environment. For instance, if your ChannelEngine environment is Sustainable Suits, its API URL should be https://sustainable-suits.channelengine.net/api/docs/#channel-api.
2. In the Authentication section, enter your Channel API key. To find your Channel API key, open a given channel, and go to Setup, General, API key.
3. Select the endpoint for which you would like to know the limit.
4. Click Test request. If the selected endpoint requires parameters, make sure to provide them before clicking Send.
5. In the Response headers section, check the values provided by the headers:

• x-rate-limit-limit - the rate limit interval, in minutes.
• x-rate-limit-remaining - the number of remaining calls within the current interval.
• retry-after - the number of seconds to wait before making another call.

View rate limits 

The table below lists the endpoints and their typical rate limits and intervals. E.g.: if a rate limit is 5 and its corresponding interval is 15, you can make 5 calls within 15 minutes.

Channel API