API-first

Definition

API-first describes a system whose API is the primary interface, designed before and independently of any user interface built on top of it.

An API-first content platform treats every editing screen as one client of the same API an integration would use. The practical test is whether anything the interface can do is also possible over the API. If some actions are only available by clicking, the system has an API rather than being API-first.

The benefit is that automation, migration and a second front end are all ordinary work rather than special cases requiring a vendor conversation.

Back to the glossary