DEV update: New authentication API call limits
Table of contents
Starting in November 2016, Geotab will introduce API call limits on the number of Authentication requests it will accept, to ensure optimal performance.
For many companies, APIs are now a central part of doing business. The API economy is thriving — look at Amazon, Salesforce, and Twitter. IBM has written that APIs are transforming business and they are “the digital glue that links services, applications and systems.” Expandability is one of the pillars of Geotab telematics — our secure open platform with free APIs, software development kit (SDK), and Marketplace are evidence of that.
Many customers and partners rely on Geotab’s APIs to unlock more value from their telematics data. Application programming interfaces (APIs) make it possible to automate processes, integrate, and simply manage your data as you like. Ensuring that developers and businesses can connect with their data easily requires constant diligence from our team. Geotab continuously monitors API calls.
Therefore, to safeguard optimal functioning and ensure that poorly written MyGeotab SDK applications do not impact the overall system performance, Geotab will be setting a limit on Authentication calls.
Important Notice on Authentication API Call Limits
Starting in November 2016, the MyGeotab API will enforce limits on the number of Authentication requests it will accept.
This change will start rolling out in November 2016 for new customers, and will be fully enforced for all customers by end of January 2017.
Questions and Answers About the Authentication Call Limit
Q: How will the Authentication calls limit affect MyGeotab users?
A: This change should not affect normal usage of the MyGeotab system. If you are using the MyGeotab SDK to make API calls, this may affect you.
Q: What is the limit? How many calls will be allowed?
A: No more than 10 Authentication requests per minute for a user are allowed. Both successful and unsuccessful Authentication calls count towards the limit.
Q: Does this affect other API calls, like Get<Device> or GetFeed<LogRecord>?
A: No, the limit applies to Authentication calls. Once authenticated, you can consume other API calls as needed. Note: Geotab actively monitors API calls. If any API abuse is suspected you will be notified.
Q:What happens when I go over the Authentication limit?
A: The server will return an OverLimitException.
Q: What should I do if I get an OverLimitException?
A: Review the Authentication section in the SDK documentation first. Your application should be using the credentials object that is returned from an Authentication request for subsequent calls. It contains a token that confirms your identity for subsequent operations. If it expires or a database is moved, a new Authentication call should be made. This approach allows for efficient usage of Authentication requests.
Q: Do I need to contact someone or do something if my limit is exceeded?
A: No, your application logic should be modified (as per above) or you are trying to Authenticate with incorrect credentials. It will automatically reset every minute.
Q: If I’m using Geotab.Checkmate.ObjectModel.dll, do I need to change anything?
A: The .Net assembly provided by Geotab already has built-in logic for handling Authentication, credentials expiry and database moves efficiently. When used correctly, no changes are needed. However, it is still possible to write code that constantly make Authentication calls for every operation.
Q: Can you give me an example of how it should be done?
Q: Can you give me an example of how it should not be done?
Watch this DEV Channel video to learn more about making your first API call.
If you liked this post, let us know!
Geotab's blog posts are intended to provide information and encourage discussion on topics of interest to the telematics community at large. Geotab is not providing technical, professional or legal advice through these blog posts. While every effort has been made to ensure the information in this blog post is timely and accurate, errors and omissions may occur, and the information presented here may become out-of-date with the passage of time.
Get industry tips and insights
Sign up for monthly news and tips from our award-winning fleet management blog. You can unsubscribe at any time.
Republish this article for free
Other posts you might like
A true asset-centric platform: MyGeotab navigation menu update for Vehicles and Trailers
September 1, 2022
Keep your fleet up and running with the Geotab Roadside Add-In
August 15, 2022
Introducing the Geotab Support Center
July 27, 2022