Governance Thresholds for Ex Libris Alma and Primo REST APIs- explained

1. REST API Governance
Thresholds
Interoperability SIWG Show & Tell
June 2016
Josh Weisman

2. From the Developer Network…
We want developers to create compelling applications and integrations,
but we also want the Alma service to always provide the best
experience possible for its users.
To maintain optimum performance and ensure that infrastructure
resources are not disproportionately used in an inefficient manner,
Alma has Governance Thresholds in place. Governance thresholds
ensure that no single institution negatively impacts other Alma
institutions, prevent performance degradation and can help reduce the
risks of malicious attacks.
https://developers.exlibrisgroup.com/alma/apis#threshold

3. Goals of the threshold
• Prevent one run-away script/program from affecting
other tenants
• Allow for effective capacity planning

4. Thresholds
Daily Threshold Concurrent Threshold
Alma 1,000 per named
user 25 per second
Primo 5 per FTE
https://developers.exlibrisgroup.com/alma/apis#threshold
https://developers.exlibrisgroup.com/primo/apis/webservices/rest

5. Calculations
Institution A Institution B Institution C
Alma named users 50 100 200
Primo FTEs 10,000 25,000 0
TOTAL per day 50,000
+ 50,000
100,000
100,000
+ 125,000
225,000
200,000
+ 0
200,000

6. Developer Network Dashboard
Organizational admin- https://developers.exlibrisgroup.com/dashboard/reports

7. Developer Network Dashboard

8. Tips for reducing API calls
• Optimize your code to eliminate any unnecessary API calls
• Cache frequently used data
• Code tables, etc.
• Cache data that is not changed often
• Libraries, etc.
• Consider batching multiple requests into a single request
• User loans, requests, fees
• Get multiple BIBs
https://developers.exlibrisgroup.com/blog/reducing-the-number-of-API-calls

9. Coming soon…
• Web hooks… say goodbye to polling!
• Preview at Developer Day @ IGELU (hopefully….)

10. Thanks!