8

Specifying an API

Specifying an API is more than converting your design into a machine-readable format. This involves applying what you’ve been learning to create something developers can use to build and consume your API. You’ll see that there are many API types and specification formats that you can use, depending on what your objectives are. You’ll learn how to connect the discoveries you made while interviewing user personas with your business objectives and technical constraints, allowing you to decide which API architectural style to use. Then, you’ll be able to actually create a machine-readable API definition document and apply API governance rules that fit your objectives.

This chapter starts by explaining how to choose what type ...

Get Building an API Product now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.