Rate Limiting

Rate Limiting

To ensure fair API usage and protect system performance, the Riyadh Parking API enforces rate limits. Understanding and managing these limits is essential for maintaining a stable and reliable integration.

Rate limits help prevent excessive API requests, ensuring a fair distribution of resources among users.

Request Type	Limit (Requests per Minute)
Authentication	20
Site Management	30
Visitor Permits	50
Violations	20
Ticket Validation	40

Request Type

Limit (Requests per Minute)

Authentication

Site Management

Visitor Permits

Violations

Ticket Validation

2️⃣ Handling Rate Limits

Check Remaining Request Quota

Every API response contains headers indicating the current usage:

X-RateLimit-Limit: 50   # Total requests allowed per minute
X-RateLimit-Remaining: 10  # Remaining requests in the current window
X-RateLimit-Reset: 1672531200  # Time (UNIX) when the limit resets

Handling 429 Errors Gracefully

Good Example
Bad Example

✅ Implement retry logic with exponential backoff:

function fetchWithRetry(url, retries = 3, delay = 1000) {
  return fetch(url).then(response => {
    if (response.status === 429 && retries > 0) {
      const retryAfter = response.headers.get("Retry-After") || delay;
      return new Promise(resolve => 
        setTimeout(() => resolve(fetchWithRetry(url, retries - 1, delay * 2)), retryAfter * 1000)
      );
    }
    return response.json();
  });
}

❌ Making continuous requests without handling rate limits:

for (let i = 0; i < 100; i++) {
  fetch("https://api.riyadhparking.com/tickets/public/active-ticket");
}

3️⃣ Best Practices for Rate Limit Optimization

✅ Cache API responses: Reduce redundant requests by storing frequently accessed data.

✅ Use pagination: When retrieving large datasets, request smaller chunks at a time.

✅ Distribute requests: Spread API calls across different time intervals instead of sending them all at once.

For high-traffic applications, consider contacting support for custom rate limit adjustments.

Getting Started

Developer Essentials

Integration Guide

Endpoints

Rate Limiting

1️⃣ Understanding Rate Limits

2️⃣ Handling Rate Limits

Check Remaining Request Quota

Handling 429 Errors Gracefully

3️⃣ Best Practices for Rate Limit Optimization

​Rate Limiting

​1️⃣ Understanding Rate Limits

​2️⃣ Handling Rate Limits

​Check Remaining Request Quota

​Handling 429 Errors Gracefully

​3️⃣ Best Practices for Rate Limit Optimization

Rate Limiting

1️⃣ Understanding Rate Limits

2️⃣ Handling Rate Limits

Check Remaining Request Quota

Handling 429 Errors Gracefully

3️⃣ Best Practices for Rate Limit Optimization