© Sanjay Patni 2017

Sanjay Patni, Pro RESTful APIs, 10.1007/978-1-4842-2665-0_2

2. API Design and Modeling

Sanjay Patni1 

(1)UCSC Excention, Santa Clara, California, USA

This chapter starts with API design strategies and then goes into API creation process and modeling. Best practices for REST API design are discussed, followed by API solution architecture. In the excercises, a simple API is designed for podcasts suscription and then modeling using RAML.

API Design Strategies

As UI is to UX (User Experience), API is to APX (Application Programming Experience ). In APX it is important o answer following questions:

  • What should be exposed?

  • What is the best way to expose the data?

  • How should API be adjusted and improved?

In addition, let’s discuss why we ...

Get Pro RESTful APIs: Design, Build and Integrate with REST, JSON, XML and JAX-RS 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.

Start your free trial