Example of API documentation auto generation

source file: here

/precondition

*

*

Preconditions:

  • HTTP/1.1 only
  • Accept: text/plain
  • user defined precondition.

precondition test

/api/documentation

GET

GET

this page

cat group

/api/cat

POST
GET

GET

get current name and age.

POST

set name and age from query parameter.

Query parameters
namenumtypedescription
namefirstText?no description
ageoptionInt
  • age of cat.
  • cute!

/api/cat/name/age

POST
nametypedescription
nameText
  • name of cat.
  • if null, homeless.
ageIntage

POST

set name and age from route.

dog group

/api/dog/i :: Int/**rest

*

*

Preconditions:

  • i is even.

twice

Preconditions:

  • i is odd.

succ