Designing RESTful APIs
1h 20mIntermediate2021-11-19
Authors

Keith Casey
Software development and project management
Course details
Having a solid understanding of how to correctly build APIs is important for any developer planning on creating websites. In this course, learn how to plan and model your own APIs, and explore the six REST design constraints that help guide your architecture. Keith Casey starts with a simple overview, including advice on identifying the users or "participants" of your system, and the activities they might perform with it. He discusses how to validate your design before you build it, and explores the HTTP concepts and REST constraints needed to build your API. To wrap up, Keith goes over some of the most common API design patterns you may encounter.
Learning objectives
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
Learning objectives
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
Skills covered
RESTAPIsFull-Stack Web DevelopmentWeb DevelopmentOpen SourceSoftware DevelopmentOne-Off
Concepts
0. Introduction
- 01 - Design a RESTful API for your organization
- 02 - Before you build an API
1. Who Needs Your API
- 03 - Why good API design is important
- 04 - Approaches to adding an API
- 05 - Tips for modeling APIs
- 06 - Identifying participants
- 07 - Identifying activities and breaking them into steps
- 08 - Case study - Identifying participants and activities
2. What Does Your API Look Like
- 09 - Creating and grouping API methods
- 10 - Mapping activities to verbs and actions
- 11 - Validating your API
3. How Does Your API Work
- 12 - REST and HTML
- 13 - HTTP header and response codes
- 14 - REST APIs - Constraints
- 15 - REST APIs - Code on demand and uniform interfaces
4. Common Design Challenges
- 16 - Authentication and authorization
- 17 - API versioning best practices
- 18 - Choosing media types and processing content
- 19 - Hypermedia approaches
- 20 - Advanced HTTP headers - Content negotiation and caching
- 21 - Documentation approaches
- 22 - SDK design considerations
Conclusion
- 23 - Next steps toward designing a RESTful API
Related courses
- Planning a Versioned RESTful API with Claude
- Building Angular and ASP.NET Web API Apps
- Java EE: Bean Validation
- Building Scalable Microservices with TypeScript and Node.js
- Designing Big Data Healthcare Studies, Part One
- Designing a Presentation (2021)
- Photoshop for Designers: Designing with Grids and Guides
- Designing Big Data Healthcare Studies, Part Two