Rate Limits

Default Limits

Rate Limit Headers

Each API response includes headers that provide information about your current rate limit status:

Rate Limit Response

When you exceed the rate limit, the API will return a 429 Too Many Requests response:

{
  "success": false,
  "error": "Rate limit exceeded",
  "code": "RATE_LIMIT_ERROR",
  "reset_at": 1678945200
}

Best Practices

• Implement exponential backoff when retrying failed requests
• Cache API responses when possible
• Monitor your rate limit status using response headers
• Consider upgrading your plan if you consistently hit rate limits

Example Implementation

import axios from 'axios';

const api = axios.create({
  baseURL: 'https://magicslides-tools-api.onrender.com/public/api'
});

api.interceptors.response.use(
  response => response,
  error => {
    if (error.response?.status === 429) {
      const resetTime = error.response.headers['x-ratelimit-reset'];
      const waitTime = Math.max(resetTime - Date.now() / 1000, 0);
      
      console.log(`Rate limit exceeded. Retry after ${Math.ceil(waitTime)} seconds`);
      
      // Implement retry logic here
      return new Promise(resolve => {
        setTimeout(() => {
          resolve(api(error.config));
        }, (waitTime + 1) * 1000);
      });
    }
    return Promise.reject(error);
  }
);

Enterprise Solutions

For enterprise customers with high-volume requirements, we offer custom rate limits and dedicated infrastructure. Please contact our sales team to discuss your specific needs.