Local API installations
If your company has strict policies that prevent you from calling cloud-based web services (such as ours), you may want to consider becoming an enterprise customer, which allows you to run your own local installation of our APIs. This document outlines some prerequisites for doing this and provides links to each API's specific installation process.
Contents
API documentation
All local installations of the Smarty APIs perform identically to Smarty's cloud-based versions, except that they don't require client authentication or authorization. Please refer to the documentation for each specific API for details about input and output fields.
Updates
Smarty publishes regular updates to local API packages. New releases are announced in our open-source Changelog repository(opens in new tab).
Minimum system requirements
The process of downloading, installing, and managing a local instance of any Smarty API requires a system administrator or software engineer who has experience with the Linux operating system and its accompanying shell environment. Responsibility for network and server maintenance (as well as the performance of all installation instructions) rests with your organization.
The server provisioned to run a local API instance should match the following criteria:
- 8 gigabytes of RAM
- 4 CPU cores
- A relatively recent version of the Linux kernel (basically something that can run compiled Go programs). Anything later than v2.6.32 should function without issues.
Using this hardware configuration, you can expect to process around 1,000 addresses per second per CPU core. This estimate assumes you’re calling the US Street Address API, and the server has been up and running for a few minutes.
API listing
Installation instructions and minimum system requirements for each API: