Skip to content

dnsimple/dnsimple-developer

main
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
bin
 
 
 
 
 
 
 
 
lib
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

DNSimple API Documentation

This is the DNSimple API documentation.

Usage

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.

Structure

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 site
  • content/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 integrations

OpenAPI definition

The 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.