​

Understanding Rate Limits

Rate limits are in place to ensure the stability and performance of the Bila API. They help prevent abuse and ensure fair usage for all developers.

​

General Guidelines

​

Handling Rate Limits

When a rate limit is exceeded, the API will return a 429 Too Many Requests response. Here’s an example of the response:

{
  "error": {
    "message": "Rate limit exceeded",
    "code": 429
  }
}

​

Best Practices

To avoid hitting rate limits, follow these best practices:

1. Implement caching: Cache API responses when possible to reduce the number of requests.

2. Use bulk operations: When available, use bulk operations instead of making multiple individual requests.

3. Implement exponential backoff: When you receive a rate limit error, wait before retrying with an increasing delay.

4. Monitor your usage: Keep track of your API usage to avoid unexpected rate limit errors.

​

Rate Limit Headers

The Bila API includes rate limit information in the response headers:

​

Example Implementation

Here’s an example of how to handle rate limits in your code:

async function makeApiRequest() {
  try {
    const response = await fetch('https://api.usebila.com/v1/resource', {
      headers: {
        'Authorization': 'Bearer YOUR_API_KEY'
      }
    });
    
    // Check if rate limited
    if (response.status === 429) {
      const resetTime = response.headers.get('X-RateLimit-Reset');
      const waitTime = resetTime - Math.floor(Date.now() / 1000);
      
      console.log(`Rate limited. Retrying in ${waitTime} seconds.`);
      await new Promise(resolve => setTimeout(resolve, waitTime * 1000));
      
      // Retry the request
      return makeApiRequest();
    }
    
    return await response.json();
  } catch (error) {
    console.error('API request failed:', error);
    throw error;
  }
}

​

Rate Limit Tiers

Different API keys may have different rate limit tiers based on your plan:

​

Requesting Higher Limits

If you need higher rate limits, you can:

1. Upgrade to a higher plan
2. Contact our support team for custom limits

​

Related Documentation

• Error Handling
• API Reference