Learn what an OpenAPI definition is and how it can help make your APIs more discoverable and testable. Explore how OpenAPI is different from schemas like HAL and Ion.
- [Instructor] Open API also known as Swagger is a popular tool for developing and testing APIs. If you haven't used OpenAPI before this video will introduce you to the key concepts. OpenAPI is a format for describing restful APIs, but it isn't quite a schema like HAL or Ion. Think of OpenAPI as introspection or reflection for your API. You can describe your API using the language agnostic OpenAPI Spec and then give this description to others to help them understand how to interact with your API.
This API description lives in a file called swagger.json. You can build a swagger.jsaon file by hand or you can generate it automatically. Swagger.json can be processed to automatically create a strongly typed client for your API or to generate API tests. Swagger.json also enables a web tool called Swagger UI which allows a human to browse to your API definition and documentation and interact with the API in real time. It's a useful tool to give to other teams or even to your API customers so they can try out your API.
Using OpenAPI and Swagger UI is totally optional and I'll continue to use Postman for the rest of this course If you are interested in using OpenAPI I'll show you how to install it in your asp.net core project.
- What is RESTful design?
- Building a new API with ASP.NET Core
- Using HTTP methods
- Returning JSON
- Creating RESTful routing with templates
- Securing RESTful APIs with HTTPS
- Representing resources
- Representing links
- Representing collections
- Sorting and searching collections
- Building forms
- Adding caching to an ASP.NET Core API
- Configuring user authentication and authorization
Skill Level Intermediate
1. REST API Concepts
2. Build a Basic API
3. Versioning and Errors
4. Secure the API
5. Represent Resources
6. Represent Links
7. Represent Collections
Add pagination7m 37s
8. Sorting Collections
9. Searching Collections
10. Forms and Modifying Data
11. Caching and Compression
12. Authentication and Authorization
- Mark as unwatched
- Mark all as unwatched
Are you sure you want to mark all the videos in this course as unwatched?
This will not affect your course history, your reports, or your certificates of completion for this course.Cancel
Take notes with your new membership!
Type in the entry box, then click Enter to save your note.
1:30Press on any video thumbnail to jump immediately to the timecode shown.
Notes are saved with you account but can also be exported as plain text, MS Word, PDF, Google Doc, or Evernote.