Use this 28-page MS Word template to document your REST/Web APIs. This template pack includes detailed examples, guidelines, and screenshots.

Includes a 16-page How to Write API Document tutorial that explains how to write each section in your API reference documentation. It 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

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


api-documentation-template-ms-word-3

api-documentation-template-ms-word-pagination

 

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

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

how-write-rest-api-documentation-parameters

API Template – Technical Details

The API Documentation Template is:

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

api-documentation-template-ms-word

Download Here