Rate Limiting

To maintain system performance and ensure fair usage for all clients, the following rate limits per minute apply to the Plum APIs:

Rate Limits for each API (Per Minute)

1. getOrderDetailsAPI: 200 requests
2. getVouchersAPI: 50 requests
3. getBalanceAPI: 10 requests
4. placeOrderAPI: 20 requests
5. getOrderHistoryAPI: 200 requests
6. getFiltersAPI: 50 requests

When the limit for any API is crossed, the system returns the following response:

{  
  "errors": [  
    {  
      "message": "auth.request_limit_exceeded",  
      "penaltySeconds": 60  
    }  
  ]  
}

Recommendations

1. Spread out API calls to avoid hitting the per-minute threshold.
2. Cache responses for static or slow-changing data such as vouchers and filters.
3. Use retries with exponential backoff, respecting the penaltySeconds value before retrying.