- Approaches to adding an API
- Modeling tips
- Identifying activities and breaking them into steps
- Mapping activities to verbs and actions
- Creating and grouping API methods
- Validating your API
- HTTP headers and response codes
- Common design challenges
- Versioning best practices
- Hypermedia and documentation approaches
Skill Level Intermediate
- [Keith] Hello, I'm Keith Casey, and this is Designing RESTful APIs. In this course we'll start with a simple overview of what it takes to add an API to your application, whether it's been around for years or you're just getting started. Our goal is to teach you to design an API which is useful for end users while respecting the HTTP concepts and REST constraints, which we'll review and describe throughout this course. And like any good design, it starts with a good definition. We'll define who will use our API and how they'll benefit from it.
Then we'll talk about the nouns and verbs that our users will use and how to apply them in clear and expressive ways. Once we understand our business workflow and the structure, we'll dive into the HTTP concepts and REST constraints that help determine our design. Finally, we'll wrap up this course by covering common API design patterns you'll have to deal with. This list isn't exhaustive, but covers the most common ones. So let's get down to business and design some effective APIs.