Posts Tagged: machine

The Return of the CLI: CLIs Being Used by API-Related Companies

Before the rise of graphical interfaces and flashy user desktops, the Command Line Interface (CLI) was the only way to interact with a computer. But the retro CLI is making a comeback.

It’s a basic form of computing — the CLI accepts text commands and interprets them into functions on the operating system. Read more

Designing a True REST State Machine

There are many misconceptions surrounding what exactly Representational State Transfer (REST) is. The prime of which is the concept of hypermedia, or defined in full context, Hypermedia as the engine of application state (HATEOAS).

Jargon aside, hypermedia is actually a valuable idea that many self-touted “RESTful” web APIs do not adhere to. Read more

What is the Difference Between API Documentation, Specification, and Definition?

Few things are as important to an industry as common understanding and definitions. Without knowing exactly what industry-specific terms mean, and how they apply to given situations, little discourse API development can take place. It seems strange, then, that there are still so many terms in the API space that are misunderstood or misused. Read more