In this video, look at the tools for generating API documentation.
- [Saleh Hamadeh] In the previous video,…we looked at security considerations for building APIs.…In this video, we're going to look at…delivering high quality documentation.…We're going to take a look at…two kinds of documentation generation tools:…annotation-based documentation,…and API design languages.…We will generate an HTML page from an API design file.…Finally, we will run a mock server of our API.…First, let's take a look at APIDOC,…an annotation-based documentation generation tool.…
Annotation-based documentation…is written within the code files,…usually in the form of block comments.…This example shows what a documentation…for a user endpoint looks like.…This block comment is usually placed…right before the definition of the outlet it refers to.…Another form of documentation…is API design files.…These are separate files that are only used…for documentation purposes.…The two most popular API design languages…are Swagger and Api Blueprint.…
In this video, we will use API Blueprint…to demonstrate API design files.…
This Node.js course gives you an overview of a RESTful API and the logical steps of creating one. It explores three different APIs, focusing on their similarities and differences and how to effectively implement one. Instructor Saleh Hamadeh starts off by defining APIs, showing how they can be built on top of HTTP and listing the properties that make an API RESTful. Learn how to develop Twitter Notes, a sample web application that lets users leave notes for their Twitter friends. Use Twitter's API to implement a login flow and then design a web API. Additionally, get a closer look at several other real-world APIs, and learn some best practices to keep APIs secure, maintainable, and efficient.
- Identifying REST resources
- Setting up the development environment
- Consuming a RESTful API
- Creating an OAuth login request
- Getting an access token
- Saving data in MongoDB
- Building a RESTful API
- Testing user-perceived performance
- Looking at APIs in the real world
- Best practices for building RESTful APIs