{"_id":"59c954001883c7003aa1300d","project":"56e3719a591f620e00bf5095","initVersion":{"_id":"56e3719a591f620e00bf5098","version":"1.1"},"user":{"_id":"56e371538b32a10e00f79750","username":"","name":"Stephan"},"__v":0,"createdAt":"2017-09-25T19:07:44.278Z","changelog":[],"body":"Dear API Partners,\n\nOur API program at Orbirental has grown in popularity and now being used by an increasing number of technical partners and Orbirental customers.\n\nIn order to improve the stability and scalability of our system, our technical team would like to inform you that starting Friday 9/29/2017, the Orbirental API will start enforcing API rate limiting. Please make sure that your client application takes this change into account. Follow the indications below to implement your changes.\n\n## Rate Limit\n\nThe Orbirental API will now allow 1,000 calls within a 1 hour window per calling client (per api key).\n\nHTTP Headers and Response Codes\n\nUse the HTTP headers in order to understand where the application is at for a given rate limit, on the method that was just utilized. The HTTP headers to monitor are the following:\n\nx-rate-limit-limit: the rate limit ceiling for that given endpoint\nx-rate-limit-remaining: the number of requests left for the 15 minute window\nWhen hitting the rate limit, please pause your code for 1 hour and retry the call.\n\n## Blacklisting\n\nIf a client application abuses the rate limits, it will be blacklisted. Blacklisted client apps are unable to get a response from the Orbirental API. If you or your application has been blacklisted and you think there has been a mistake, you can email us at api@orbirental.com to request assistance.\n\nIn any case, please feel free to reach out if you have any question / concern.","slug":"api-rate-limiting-coming-friday-9292017","title":"API Rate Limiting coming Friday 9/29/2017"}

API Rate Limiting coming Friday 9/29/2017


Dear API Partners, Our API program at Orbirental has grown in popularity and now being used by an increasing number of technical partners and Orbirental customers. In order to improve the stability and scalability of our system, our technical team would like to inform you that starting Friday 9/29/2017, the Orbirental API will start enforcing API rate limiting. Please make sure that your client application takes this change into account. Follow the indications below to implement your changes. ## Rate Limit The Orbirental API will now allow 1,000 calls within a 1 hour window per calling client (per api key). HTTP Headers and Response Codes Use the HTTP headers in order to understand where the application is at for a given rate limit, on the method that was just utilized. The HTTP headers to monitor are the following: x-rate-limit-limit: the rate limit ceiling for that given endpoint x-rate-limit-remaining: the number of requests left for the 15 minute window When hitting the rate limit, please pause your code for 1 hour and retry the call. ## Blacklisting If a client application abuses the rate limits, it will be blacklisted. Blacklisted client apps are unable to get a response from the Orbirental API. If you or your application has been blacklisted and you think there has been a mistake, you can email us at api@orbirental.com to request assistance. In any case, please feel free to reach out if you have any question / concern.