REST/Web API Template (MS Word) + Tutorial

Need to write API documentation but don’t know where to start? We hear you. We’ve been there. That’s why we created this easy-to-use template to get you started and put a framework in place for your API reference documents. It also includes a 16-page tutorial that explains what you need to include in your API documents, with example of how to describe your endpoints, parameters, and other settings.

This template isn’t for expert or senior tech writers. Rather, it’s for junior tech writers, developers, or anyone else who’s been asked to document an API and needs some help to get started. The price is pretty reasonable when you think how long it would take to come up to speed and create your own writing guidelines. That’s it. Here’s what’s inside.

  • Use this 28-page MS Word template to document your REST/Web APIs. This template pack includes detailed examples, guidelines, and screenshots.
  • You also get a 16 page How to Write API Document tutorial that explains how to write each section in your API reference documentation. It includes helpful explanatory text that walks you through the process of documenting each section in the API, including the parameters, endpoints, requests, responses, and endpoints.

You can change everything in the document – text, images, and tables. There are no special plug-ins, macros, or installation files.

api-documentation-template-ms-word

API Template - Download Here

Why Write API Reference Documentation?

If your company develops APIs, then you can use this MS Word template to write reference documentation for each API available with the product. The API documentation describes the common components used by each of the APIs for iOS, Android, and other platforms. Use the API reference documentation to explain the data structures available through the APIs.

This will increase the usage and popularity of your APIs and encourage developers, testers, and integrators to use your API products.

api-documentation-template-ms-word-1

This is the cover page – you can remove the image if you want to – with the document conventions and legal text.

api-documentation-template-ms-word-3

Each section includes explanatory text, tables to present the information, and sample default values to put things in context.

api-documentation-template-ms-word-pagination

The document is designed to be read. We use lots of white space and tables to make it easy to scan the text and find what you’re after.

API Template - Download Here

Who is this API template for?

This API template was written for the following:

  • Technical writers who are new to API documentation and want a template to get them started.
  • Developers who’ve been asked to write a quick API document and need a template, with guidelines they can follow, to get the API documented as fast as possible.
  • IT Managers who want to ensure all of their team follow the same guidelines when writing API document, even rough drafts to get started.

http-request-format

Examples of the structure of requests and responses.

http-response-format

Table of Contents

The API template includes the following chapters:

1.0 Overview

1.1. Conventions

1.2. Current Version

1.3. Schema

1.4. HTTP Redirects

1.5. HTTP Requests

1.6. HTTP Methods

1.7. Authentication

1.8. Pagination

1.9. Rate Limiting

1.10. URL Format

2.0 API Reference Documentation

2.1. Overview

3.0 Resource Name [with instructions]

3.1. Resource Information

3.2. Request

3.1. Parameters

3.2. Authorization

3.3. Response

3.1. Samples

4. Resource Name [#1]

4.1. Resource Information

4.2. Request

4.3. Parameters

4.4. Authorization

4.5. Response

4.6. Samples

5. Resource Name [#2]

5.1. Resource Information

5.2. Request

5.3. Parameters

5.4. Authorization

5.5. Response

5.6. Samples

6. Query Parameters

7. Status Codes

How to Write API Documentation – Free eBook

You also get a 16-page How to Write API Document tutorial that explains how to write each section in your API reference documentation.

It includes helpful explanatory text that walks you through the process of documenting each section in the API, including the parameters, endpoints, requests, responses, and endpoints.

The How to Write API Document ebook is:

  • Page Count: 16 Pages
  • Language: US English
  • File Format: PDF

how-write-rest-api-documentation

how-write-rest-api-documentation-sample-requests

We included screenshots of best practice APIs so you can see how others write and present their APIs.

how-write-rest-api-documentation-parameters

We then walk you through how to document the paths, parameters, settings, as well as default values and other parts of the reference document.

API Template – Technical Details

Here are details of the actual API Documentation Template that you can download:

  • Page Count: 28 Pages
  • Language: US English
  • File Format: Microsoft Word .docx format
  • Also includes How to Write API Documentation: PDF

api-documentation-template-ms-word

API Template - Download Here

Product Specifications

File Format: The templates are in Microsoft Word  (.docx) format.

Opening the Files: You don’t need any special software to unzip the files. To unzip the files, right click on it, then select Extract, and save it to your computer.

Getting Started: Depending on your MS Office settings, the files may say Read Only when you open them. If this occurs, click FileSave As and save the files. There are no security settings on any of the files.

Images: All of the images in the templates are copyright free.

 60-day Money-Back Guarantee

 Secure Online Order Form

FAQs

Who are your Customers?

Here is a sample list of our customers.

Technical Support

I am here to help you with any questions. You can contact me directly if you need any helping using these templates.

What file formats do the templates work in?

The files work in MS Word 97, 2003, 2007, Office 2010, Office 2016, Windows 7, XP, Vista, and Apple iWork (if you have Word for Mac), and Google Docs.

How do I get my templates?

After you make the payment, you are sent an email. This has a link to a Download Page from where you can save the templates,

Where are my templates?

By default, when you download the files, they are saved to the Download folder on your computer.

What is the refund policy?

We offer a 60 days refund policy.

I have not received my product. Who do I contact?

Please email ivan at klariti.com or info at klariti.com or ivanawalsh at gmail.com. Please include your order number.

Help! I’ve accidentally deleted my templates!

Just drop us a line with the order number. We’ll send it out.

Why does my file say it’s corrupt?

If you open a zip file during the download, it may display an error message that the file is corrupt. What this means is that not all of the file have downloaded and therefore the system thinks its contents are corrupt. Please try to download the file again or contact us for assistance. Email us the receipt number you received from eJunkie and we’ll send you another copy.

How Do I Buy the Templates?

This page explains the order process.

It shows how to order templates, how can you pay (with PayPal or with Credit Cards), and how to download the template.

How do I Download the Templates?

After you buy the order, you’ll get an email with a link to download the templates.

If you have any problem downloading the templates, send me the order number and I will get back to you.

Please allow 12 hours for a response as our time zone may be different than yours.

How do I Pay with my Credit Card (Instead of PayPal)

This page explains how to buy templates using your credit card instead of PayPal.

Note: You do NOT need a PayPal account to place an order. You can pay for your order using your credit or debit card.

Read How to Pay with Your Credit Card (Instead of PayPal) here.

How Can I Contact You?

You can contact me at:

  • Email: ivan at klariti.com / info at klariti.com / ivanawalsh at gmail.com
  • Tel: 00.353.860.886.349
  • Facebook / Twitter

As we’re in Europe, there may be a time difference when getting back to you.

Again, if there are any problems, just let me know.

Regards,

Ivan Walsh

Related Products

Software Development Templates – MS Office – Apple iWorks

Software Testing Templates – MS Office – Apple iWorks