© Thomas Hunter II 2017

Thomas Hunter II, Advanced Microservices , 10.1007/978-1-4842-2887-6_2

2. HTTP API Design

Thomas Hunter II

(1)San Francisco, California, USA

An application programming interface (API) represents a contract between the data and business logic provided by your service and the consumers who want to interact with this data. Breaking this contract will result in angry e-mails from developers and anguished users with broken apps. Designing an externally facing and hard-to-use API will result in few or no third-party developers using it. Similarly, if you do this with an internal API, then people will talk about you behind your back.

On the other hand, building a great external API and adhering to this contract will result in substantially ...

Get Advanced Microservices: A Hands-on Approach to Microservice Infrastructure and Tooling now with the O’Reilly learning platform.

O’Reilly members experience live online training, plus books, videos, and digital content from nearly 200 publishers.