Search results

Activity: Create an OpenAPI specification document

The OpenAPI tutorial walked you through 8 steps in building the OpenAPI specification document. Now it’s your turn to practice building out an OpenAPI specification document on your own.

Identify an API

In an earlier activity, you found an open-source API project with some documentation needs. Create an OpenAPI specification for this API.

If you don’t want to use that API (maybe it already has an OpenAPI specification document, or there are other complications), you can use this simple Sunrise and sunset times API. This Sunrise and sunset times API doesn’t require authentication with requests, so it removes some of the more complicated authentication workflows.

Depending on the API you choose to work with, you could potentially use this specification document as part of your portfolio.

Follow the OpenAPI tutorial

Go each step of the OpenAPI specification tutorial to build out the specification document:

Make sure your spec validates

Validate your specification document in the Swagger Editor. Execute a request to make sure it’s working correctly.

Check your spec against mine

If you get stuck or want to compare your spec with mine, see openapi_sunrise_sunset.yml.

Note that the Sunrise and sunset times API doesn’t require authorization, so you can skip Step 6: security object.

You can use this OpenAPI specification document when working through the Swagger UI activity.

74% Complete

74/101 pages complete. Only 27 more pages to go...


Would you like to help encourage more content development and updates? If so, click the Donate button below to donate $10 through Paypal.

Get new posts delivered straight to your inbox.

Subscriber count: 4,285