Apps & Software
What is an API?
Also called application programming interface.
Short definition
An API (application programming interface) is a doorway an application provides so other applications can request data or run its functions automatically, without human involvement.
How it works
The requesting application sends a request to a specific address, for example “give me the status of order number 1024”, along with an access key. The providing application checks the permission, then returns an answer in a machine-readable format, usually JSON. The rules for requests and answers are written in the API documentation, so other teams can use it without seeing the code behind it.
Example in a company
An online store shows shipping costs by calling a courier's API. A mobile app and a website use the same API to read data from a single backend. A sales system sends transactions to the accounting application through an API, so nobody has to re-enter them from a spreadsheet.
What to watch out for
API keys are treated like passwords: they are never placed in publicly visible code, and they can be revoked if leaked. Every request is checked for access rights, the number of requests is limited to prevent abuse, and API changes are versioned so applications that already use it do not suddenly break.
Further reading
Resources
- MDN Web Docs: API (developer.mozilla.org)