This is the DNSimple API documentation.
This website is built with nanoc. If you want to learn how to run the site locally, or how to contribute, please visit the CONTRIBUTING file.
These are the most important folders and files to keep in mind while working on this repo:
content: this folder contains the markdown files that generate the sitecontent/v2/openapi.yml: the API definition described using the OpenAPI specification (see below)examples: this folder contains the API response fixtures generated from real API calls you can use to test your integrationsThe API behavior is described using the OpenAPI specification. The definition file is located at content/v2/openapi.yml.
The OpenAPI description is the main source of truth, and must be kept up to date with the other changes in the site. At the time being, the site and the OpenAPI must be kept in sync manually. That means any change in the markdown documentation files needs to be reflected in the OpenAPI file.
The markdown documentation is a subset of the OpenAPI description. There may be information that - for the sake of brevity - are omitted in the markdown files, and sometimes delegated to the OpenAPI description.