3 Designing a programming interface

This chapter covers

  • Transposing API goals into a programming interface
  • Identifying and mapping REST resources and actions
  • Designing API data from concepts
  • Differentiating between REST APIs and the REST architectural style
  • Why the REST architectural style matters for API design

In the previous chapter, you learned how to identify an API’s goals—what users can achieve using it. For a Shopping API, some of these goals could be search for products, get product, add product to cart, check out cart, or list orders. These goals form the API’s functional blueprint that we will use to design the actual programming interface that is consumed by its users (developers) and their software. To design this programming interface, ...

Get The Design of Web APIs 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.