General technology reading / 02
A defined way for programs to talk
Illustrative line study
An application programming interface, or API, defines how software can use a capability exposed by other software. It lets a program make a request through an agreed interface.
The shape of a request
An interface describes the operations available and the information each request needs. For a web API, a request is sent over a network and a response returns data or an error. Other APIs work within a device or application. The term does not always imply an internet connection.
A hypothetical catalogue
Imagine a library catalogue that allows another program to request books by an author. The requesting program supplies the author in the required format. The catalogue returns matching records. The receiving program can display those records in its own layout without knowing how the catalogue stores them.
Agreement has limits
An API makes certain interactions possible; it does not make every internal detail available. A useful description explains required inputs, returned fields and failure responses. Readers can ask whether an operation only retrieves information or also changes it. That question reveals the consequences of a request before the interface is used. Clear boundaries make a technical conversation more precise.
Further reading: Cloudflare’s API explanation.