We may earn an affiliate commission when you visit our partners.
Course image
Peter Gruenbaum

This is the second in a series of courses for technical writers who want to learn how to write API documentation. The first course is called "Learn API Technical Writing: JSON and XML for Writers", and it is recommended that you first take that course, unless you are very familiar with JSON and XML, and how to document them.

This course teaches how to document REST APIs. No programming experience is required, but technical writers with programming experience who want to know more about REST APIs will still find it useful.

What are APIs?

Read more

This is the second in a series of courses for technical writers who want to learn how to write API documentation. The first course is called "Learn API Technical Writing: JSON and XML for Writers", and it is recommended that you first take that course, unless you are very familiar with JSON and XML, and how to document them.

This course teaches how to document REST APIs. No programming experience is required, but technical writers with programming experience who want to know more about REST APIs will still find it useful.

What are APIs?

APIs (Application Program Interfaces) define how software systems talk to each other, and API documentation is a rapidly growing field. There is a strong need for writers who can understand APIs and explain them so that software developers can understand how to use them. API writers get to be in on the cutting edge of technology in high-paying positions.

What is REST?

REST (Representational State Transfer) is a popular style of web API, and it's used to communicate data between devices and servers. Different data is contained in different parts of the API requests and responses, and this course explains what those different parts are and how to document them.

What is in This Course?

By the end of the course, you will understand what REST is and how to read and document REST requests and responses. In this course you'll find:

  • 12 videos that:
    • Provide background information on REST APIs
    • Break down REST requests into their various pieces with examples
    • Show real-time, narrated writing of REST documentation
    • Provide overviews of authentication and authorization for REST
  • 7 hands-on exercises to lead you through making and documenting REST requests
  • 7 short quizzes to keep you on your toes
  • PowerPoint presentations as a resource for every video lecture
  • A Microsoft Word document you can use as a template for REST reference material

The course takes approximately 3 hours and 30 minutes to complete, depending on how fast you are with the exercises.

Enroll now

What's inside

Learning objectives

  • Understand the basics of how rest works.
  • Understand the basics of authentication and authorization.
  • Create reference documentation for rest requests.

Syllabus

Students will understand what is covered in this course and what REST is.

This introduction explains:

  • What will be covered in the course
  • What APIs are
  • Why API documentation is important
Read more

This lecture covers what REST is. At the end, students should know:

  • REST is a type of web API
  • The difference between design patterns and protocols
  • How RESTful APIs use HTTP, requests, responses, and resources
  • How REST compares to SOAP

Answer the following questions about REST.

This lecture covers how REST requests work. At the end, students should understand:

  • What a request is
  • The different parts to a request:
    • Method
    • URL
    • Query parameters
    • Headers
    • Body

Identify part of a REST request

This lecture covers REST resources. At the end, students should understand:

  • What a resource is
  • How resources are represented in URLs
  • What endpoints are
  • How to specify either multiple or singular resources
  • How resources can contain other resources

Short note on resource names

Choose the most likely resource for the given task.

This lecture covers HTTP methods. At the end, students should understand:

  • What a method is
  • What are CRUD operations
  • When the methods GET, POST, PUT, and DELETE are used

Match up the actions with the most appropriate method.

This exercise has you making REST calls to learn how to use the different HTTP methods.

This exercise teaches you how to document the method and the URL for a resource.

This lecture covers query parameters. At the end, students should understand:

  • What query parameters are
  • How they are used in REST
  • How to document them

This lecture covers headers. At the end, students should understand:

  • What headers are
  • How to use headers to specify formats
  • How to use headers for authorization
  • How to document headers

Note: This lecture is technically the most difficult. If you are finding it hard to understand, don't get discouraged. Just skip it and come back to it at the end.

This lecture covers authentication and authorization. At the end, students should understand:

  • The difference between authentication and authorization
  • What app keys are
  • What OAuth is and a bit about how it works
  • Generally, how to document authentication and authorization

This lecture covers request bodies, response bodies, and errors. At the end, students should understand:

  • Where is structured data used in REST?
  • What URLs in response data means
  • Sample requests and responses
  • How to document HTTP status codes

This lecture covers how to put all of the information from the course together to write reference API documentation. Two examples are documented in real time.

This lecture covers tools for documenting and calling REST APIs. At the end, students should understand:

  • How tools can help
  • The differences between single source tools, content management systems, and autogenerated documentation tools
  • What Markdown is
  • How to use a REST client to make REST API calls

This lecture is a review of the course, and includes:

  • A summary of each lecture
  • A description of next steps to writing complete REST API documentation

Traffic lights

Read about what's good
what should give you pause
and possible dealbreakers
Teaches REST API documentation, which as seen significant growth
Provides an understanding of the basics of how REST works, which is core for many roles in software development
Provides an understanding of authentication and authorization, which are crucial for the security of REST APIs
Provides hands-on exercises and quizzes, which reinforce the learning experience
Requires no programming experience, which makes it accessible to a broader audience
Taught by experienced instructors, which ensures the quality of the content
Recommended to have familiarity with JSON and XML, which may be a limitation for some learners
Could cover more advanced topics, such as API design patterns and security best practices

Save this course

Create your own learning path. Save this course to your list so you can find it easily later.
Save

Reviews summary

Essential rest api documentation for writers

According to learners, this course is an absolute gem for technical writers aiming to master API documentation, specifically for REST APIs. It stands out by breaking down complex concepts into easily digestible lessons, making them approachable for those new to the field. Students consistently highlight the practical approach and invaluable hands-on exercises, which provide real-world application and solidify understanding. The course is seen as concise yet comprehensive, offering a solid foundation and boosting confidence in API documentation projects. It's also an excellent complement to the preceding JSON/XML course.
Builds strong foundational knowledge and boosts confidence.
"This course provides a solid foundation, enabling you to approach API documentation projects with confidence."
"I now feel much more confident in tackling API documentation projects."
"It’s concise but comprehensive, providing a solid foundation."
Simplifies complex REST and API documentation concepts.
"It explains topics from scratch, making complex concepts easy to grasp for those new to the field."
"I particularly appreciate how it demystifies authentication and authorization, often stumbling blocks for non-programmers."
"It clarifies complex topics like authentication very well."
Offers practical experience through invaluable exercises.
"The hands-on exercises are particularly helpful, as they give you real-world experience."
"The practical exercises are invaluable, reinforcing the theoretical knowledge with hands-on application."
"The content is well-explained, and the hands-on exercises are very beneficial for practical application."
Tailored specifically for technical writers and non-programmers.
"This course on API Documentation is a complete guide to understanding REST APIs from a writer's perspective."
"For technical writers wanting to delve into API documentation, this course is an absolute gem."
"It explains the core concepts of REST APIs in a way that is highly relevant to documentation, avoiding unnecessary programming jargon."
Suggests expanding coverage on common tools and workflows.
"My only minor suggestion would be to perhaps include a brief section on common tools or workflows used in real-world API documentation teams..."

Activities

Be better prepared before your course. Deepen your understanding during and after it. Supplement your coursework and achieve mastery of the topics covered in Learn API Technical Writing 2: REST for Writers with these activities:
Review REST basics
Review the basics of REST to ensure a strong foundation for this course.
Browse courses on REST
Show steps
  • Review the course syllabus and identify key REST concepts.
  • Read online articles and tutorials on REST principles and methods.
  • Complete hands-on exercises or simulations to practice using REST APIs.
Review the book "RESTful Web Services Cookbook"
Gain insights and practical guidance on RESTful web services through this recommended book.
View RESTful Web APIs on Amazon
Show steps
  • Purchase or borrow a copy of "RESTful Web Services Cookbook".
  • Read through relevant sections on REST API design, documentation, and best practices.
  • Apply the concepts you learn to your own REST API documentation projects.
Practice Making RESTful API Calls
Reinforces the concepts of making RESTful API calls and working with request and response structures.
Show steps
  • Use an API testing tool like Postman to make GET, POST, PUT, and DELETE requests to a RESTful API.
  • Inspect the HTTP headers and bodies of the requests and responses to understand their structure and content.
  • Practice sending requests with different parameters and payloads to observe the effects on the responses.
Two other activities
Expand to see all activities and additional details
Show all five activities
Write a Blog Post on RESTful API Design
Provides an opportunity to synthesize and communicate understanding of RESTful API design principles.
Browse courses on Technical Writing
Show steps
  • Choose a specific aspect of RESTful API design to focus on, such as resource naming or error handling.
  • Research and gather information on the topic.
  • Write a blog post that explains the topic clearly and concisely.
Contribute to an Open Source RESTful API Project
Provides hands-on experience in applying RESTful API design principles and working on real-world projects.
Browse courses on API Development
Show steps
  • Find an open source RESTful API project on platforms like GitHub.
  • Review the project documentation and identify an area where you can contribute.
  • Submit a pull request with your proposed changes or additions.

Career center

Learners who complete Learn API Technical Writing 2: REST for Writers will develop knowledge and skills that may be useful to these careers:

Reading list

We've selected 50 books that we think will supplement your learning. Use these to develop background knowledge, enrich your coursework, and gain a deeper understanding of the topics covered in Learn API Technical Writing 2: REST for Writers.
Provides a comprehensive overview of authentication systems, from the basics to the most advanced topics. It is an excellent resource for anyone who wants to learn more about this complex and challenging field.
Revered across the web engineering industry as the foundational masterpiece on HTTP/1.1 semantics, Gourley and Totty dissect request/response message framing, persistent keep-alive connections, caching headers, forward/reverse proxies, and content negotiation in exhaustive detail.
Analyzing how TCP slow-start, TLS 1.3 handshakes, and head-of-line blocking shaped the evolution from HTTP/1.1 to binary-framed HTTP/2 streams, Grigorik provides the definitive performance engineering guide to web transport.
Examines access control policy languages, providing a theoretical foundation and practical guidance on developing and evaluating authorization policies.
Provides practical guidance for engineers on creating effective technical documentation, including API docs. It offers hands-on strategies and real-world examples, making it highly relevant for those building or documenting APIs from a development perspective. It's particularly useful for developers new to the nuances of documentation.
An exhaustive reference for XSLT 2.0 and XPath 2.0, written by a leading expert in the field. is invaluable for deeply understanding and utilizing these transformation and querying languages. It's a core resource for advanced undergraduate students, graduate students, and professionals.
Classic guide to RESTful web APIs, providing detailed guidance on how to design, build, and document APIs that meet the needs of both developers and consumers.
Provides a comprehensive reference to Markdown syntax, suitable for both beginners and experienced users. It covers the basics and more advanced formatting techniques. It highly recommended reference for anyone working with Markdown regularly.
Multiplexed binary streams, HPACK header compression, stream prioritization, server push pitfalls, and the transition toward QUIC and HTTP/3 are explained with packet-level diagrams and real server configurations by Barry Pollard.
Authored by Akamai chief architect Stephen Ludin and Javier Garza, this concise O'Reilly guide shows web developers and ops engineers how to inspect h2 frames in Wireshark and Chrome DevTools and stop legacy HTTP/1.1 anti-patterns like domain sharding.
Dives into using OpenAPI Specification (formerly Swagger) for designing and documenting APIs. Given the prevalence of OpenAPI in API documentation tools, this book is highly relevant for hands-on learning and mastering contemporary documentation practices. It's a practical guide for those working with these specific tools.
Dives into role-based access control (RBAC), providing a comprehensive overview of the RBAC model, its variations, and its applications in various domains.
Specifically tailored for technical writers, this book breaks down the basics of APIs and the documentation process. It's an excellent starting point for technical writers new to documenting APIs, providing foundational concepts and guidance on structuring effective documentation.
Focuses on the OAuth 2 protocol, providing a comprehensive guide to understanding its concepts, implementing it, and addressing various security considerations.
Provides a comprehensive overview of identity and access management in cloud computing, including authentication and authorization. It is an excellent resource for anyone who wants to learn more about this important topic.
Provides a comprehensive overview of authentication protocols for wireless networks. It is an excellent resource for anyone who wants to learn more about this critical topic.
Provides a comprehensive overview of biometric authentication methods, including fingerprint, face, iris, and voice recognition. It is an excellent resource for anyone who wants to learn more about this rapidly growing field.
This practical guide provides a comprehensive overview of RESTful web services, with a focus on best practices for designing and implementing RESTful APIs.
Considered a definitive guide to XML Schema, this book provides in-depth coverage of designing and implementing XML schemas. It's essential for anyone needing to define and validate XML document structures rigorously and is suitable for undergraduate and graduate students, as well as professionals.
Examines HTTP/1.1, HTTP/2, and QUIC/HTTP/3 from the wire protocol level upward, comparing how REST, GraphQL, gRPC, and WebSockets leverage transport semantics in modern distributed systems.
Based on industry standards, this book provides guidance for creating professional API documentation for various technologies. It's a valuable resource for understanding established practices and ensuring high-quality, usable API documentation.
Focusing on best practices for designing and documenting RESTful APIs, this book explains the principles behind effective API design, which directly impacts the quality of documentation. It's a crucial read for anyone involved in the design phase of APIs and provides a strong foundation for understanding what needs to be documented.
A comprehensive reference covering XML, DTDs, schemas, XSLT, XPath, and other related technologies. is valuable for gaining a broad understanding and serves as a handy reference for developers. It's suitable for those with some basic programming knowledge.
Offers a comprehensive tutorial and reference for XQuery 3.1, the W3C standard language for querying XML data. It covers querying XML databases and extracting information effectively. It's suitable for those with a basic understanding of XML and key resource for data professionals.
A guide to best practices for implementing and working with DITA. is essential for technical writing teams and individuals involved in creating and managing DITA content. It offers practical advice for real-world DITA projects.
Another excellent resource for Java developers, this book explores how to effectively integrate XML into Java applications. It covers various XML technologies and their application within the Java ecosystem.
Focuses specifically on the design of web APIs, offering insights that are directly relevant to documenting them effectively. Understanding the design principles discussed in this book will significantly aid in creating clear and accurate API documentation.
Provides a solid introduction to XML fundamentals, including its purpose, syntax, and associated standards like CSS, XSL, XLink, and XPointer. It's an excellent starting point for anyone new to XML, explaining concepts with real-life examples. It helps solidify basic understanding and is suitable for beginners.
Provides a comprehensive guide to securing XML-based web services and applications. It covers security threats and vulnerabilities related to XML and offers practical solutions, highly relevant for professionals in cybersecurity and web development.
Configuring production HTTP/2 and HTTP/3 termination, TLS cipher suites, reverse-proxy upstream keepalives, gzip/Brotli compression, and rate limiting in NGINX puts HTTP protocol mechanics into immediate operational practice.
Written by a Microsoft MVP provides advanced techniques and tips for using Microsoft Word.
Provides practical insights and in-depth explanations of the Darwin Information Typing Architecture (DITA). It's crucial for technical writers and information architects working with structured content and is highly relevant to contemporary technical documentation practices.
Is tailored for C# developers and covers XML processing and data access within the .NET framework. It includes working with XMLDocument, XDocument, LINQ to XML, and integrating XML with databases.
Modern HTTP on the open internet is almost exclusively HTTPS. Qualys SSL Labs creator Ivan Ristić provides the authoritative reference on TLS 1.3 handshakes, ALPN protocol negotiation, HSTS, OCSP stapling, and certificate transparency.
Save
Focuses on the design of web APIs, emphasizing creating APIs that developers will find easy to use and understand. Good API design is foundational to good API documentation, making threlevant read for understanding the user perspective.
Focused on applying XML within the Microsoft .NET framework, this book covers XML parsing, manipulation, and data access using .NET technologies. It's highly relevant for .NET developers working with XML.
Another book dedicated to XML processing with Python, covering topics like transforming XML with XSLT, querying with XPath, and working with XML dialects. It provides practical examples for integrating XML into Python projects.
Offers insights into integrating documentation within an agile product development environment, which is common for API development. It emphasizes treating documentation as a product, focusing on user needs and the value of documentation in the success of a product.
Google security legend Michal Zalewski dissects how browsers parse HTTP headers, cookies, Same-Origin Policy boundaries, CORS preflight checks, and MIME-sniffing quirks—and how subtle ambiguities create critical web vulnerabilities.
This guide focuses on designing REST APIs, covering practices and tools for designing, sharing, and documenting APIs. It provides a strong foundation in API design from a developer's perspective, which is beneficial for technical writers documenting these APIs.
A collection of practical solutions and examples for common XSLT tasks. valuable reference for developers working with XSLT and provides ready-to-use code snippets for various transformation scenarios.
Provides in-depth coverage of all the features and functions of Microsoft Word 2021.
While not specifically about REST, this book provides a deep dive into the design principles and patterns used in data-intensive applications, which are often implemented using RESTful APIs.
Focuses on using Markdown in conjunction with Git for content creation and version control. It's particularly relevant given the course titles mentioning version control and Git workflows. It provides practical guidance for managing content using these tools.
Provides a comprehensive overview of JSON, covering its syntax, data structures, and usage in web development.
Provides a comprehensive guide to using Postman, a widely used tool in API development and documentation. It covers documenting APIs within the Postman workflow, making it a practical resource for those using or planning to use Postman for their API documentation.
Applies HTTP status codes, content negotiation, caching headers, and idempotent method semantics to production REST architectures, bridging protocol rules with scalable backend service design.

Share

Help others find this course page by sharing it with your friends and followers:

Similar courses

Here are nine courses similar to Learn API Technical Writing 2: REST for Writers.

Udemy Buyer Protection & Guarantee

Verified partner policies & purchase protections

Global Marketplace Leader
Free Trial & Audit

Free Lecture Previews

Free preview video lectures available for all courses; optional 7-day free trial on Personal Plan subscriptions (cancel before trial ends to avoid conversion).

Return & Refund Policy

30-Day Money-Back Guarantee

30-day money-back guarantee on all eligible individual course purchases (provided course content has not been substantially consumed or downloaded). Subscription fees are non-refundable once billed.

Buyer Protections

Verified Academic & Industry Partner

Lifetime access to purchased individual courses and future updates, verifiable certificate of completion, and direct student Q&A forums.

Key Purchase Protections
30-day 100% money-back guarantee on course purchases
Lifetime access on web, mobile, and offline
Certificate of completion included with purchase
Direct instructor Q&A and active student community
OpenCourser Verified Partner Policy details last reviewed: 2026-10-22
Our mission

OpenCourser helps millions of learners each year. People visit us to learn workspace skills, ace their exams, and nurture their curiosity.

Our extensive catalog contains over 50,000 courses and twice as many books. Browse by search, by topic, or even by career interests. We'll match you to the right resources quickly.

Find this site helpful? Tell a friend about us.

Affiliate disclosure

We're supported by our community of learners. When you purchase or subscribe to courses and programs or purchase books, we may earn a commission from our partners.

Your purchases help us maintain our catalog and keep our servers humming without ads.

Thank you for supporting OpenCourser.

© 2016 - 2025 OpenCourser