Creating API Documentation
30mBeginner2022-07-21
Authors

Deepa Maddala
Experienced Consultant and PL/SQL Developer in Information Technology
Course details
With so many APIs on the market, it’s hard to keep track of what’s what. For programmers, analysts, architects, and technical writers who work with APIs every day, you can’t overstate the importance of documentation that’s clear, concise, and easy to use. In this course, instructor and developer Deepa Maddala shows you how to create effective and approachable API documentation based on current best practices and integrated tools.
Learn the fundamentals of APIs and the importance of writing standardized API documentation. Explore the components of effective documentation including name, description, endpoints, authorization, parameters, headers, and request and response payloads. Along the way, Deepa gives you tips on how to integrate your documentation with tools like Swagger, Postman, and Confluence.
Learn the fundamentals of APIs and the importance of writing standardized API documentation. Explore the components of effective documentation including name, description, endpoints, authorization, parameters, headers, and request and response payloads. Along the way, Deepa gives you tips on how to integrate your documentation with tools like Swagger, Postman, and Confluence.
Skills covered
APIRESTAPIsOpen SourceSoftware DevelopmentOne-Off
Concepts
0. Introduction
- 01 - Introduction to APIs
1. API Foundations
- 02 - What is an API
- 03 - Types of APIs
2. API Documentation
- 04 - What is API documentation
- 05 - The importance of API documentation
3. Components of API Documentation
- 06 - Name, description, and endpoints
- 07 - Authorization, parameters, and headers
- 08 - Request and response
4. Integrating Documentation with API Tools
- 09 - Swagger
- 10 - Postman
- 11 - Confluence
Conclusion
- 12 - Next steps
Related courses
- Learn API Documentation with JSON and XML
- Planning a Versioned RESTful API with Claude
- Building APIs with Swagger and the OpenAPI Specification
- Designing RESTful APIs
- Build with AI: Creating a SaaS MVP in One Day
- Learning GraphQL (2021)
- Enhancing Your Productivity as a Data Scientist with Generative AI
- Web Servers and APIs using C++
Related learn paths
- Prepare for the Cisco Certified DevNet Associate (200-901 DEVASC) Certification Exam
- Getting Started as an ASP.NET Developer
- Prepare for the MTA: Software Development Fundamentals Exam (98-361)
- Become a RESTful API Developer
- Stay Ahead in GraphQL
- Twilio Programmable Messaging and Voice Professional Certificate
- C# Foundations: From Basics to Building Blocks
- Become a FileMaker Custom App Developer