Skip to content

API Documentation

This section contains documentation I’ve written for two APIs as part of my technical writing portfolio:

  • Weather API — Based on the real OpenWeather API, providing current weather, forecasts, and related data.
  • Payments API — A sample API I created to demonstrate how financial/payment systems could be documented.

What’s Included

For each API, the documentation is structured into:

  • Overview — Introduction and key features.
  • Authentication — How to access the API.
  • Endpoints — Parameters, request examples, and responses.
  • Errors — Error codes and handling guidelines.
  • Quickstart — A simple step-by-step example to get started.

FAQs

Q: Are these production APIs?
A: The Weather API is based on the real OpenWeather API. The Payments API is a mock API, created for documentation demonstration purposes.

Q: Can I test the APIs?
A: Yes you can test the Weather API using your own OpenWeather API key. The Payments API examples are illustrative only.

Q: Why document them?
A: To showcase technical writing skills, including structuring docs, writing clear examples, and explaining authentication, endpoints, and error handling.

Note

This section is part of a portfolio project designed to highlight technical documentation skills.