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 O’Reilly online learning.

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