apidoc generator 0.11.80

Documentation for an apidoc code generator API

Resources

generator

Operations

Method and Path Description
GET /generators

Get all available generators

GET /generators/:key

Get generator with this key

healthcheck

Operations

Method and Path Description
GET /_internal_/healthcheck

invocation

Operations

Method and Path Description
POST /invocations/:key

Invoke a generator

Headers

No headers

Imports

http://www.apidoc.me/bryzek/apidoc-common/latest/service.json
http://www.apidoc.me/bryzek/apidoc-spec/latest/service.json

Enums

No enums

Models

attribute

Example Json: Minimal | Full

An attribute represents a key/value pair that is optionally used to provide additional instructions / data to the code generator. An example could be an attribute to specify the root import path for a go client..

Field Type Required? Default Description
name string Yes -

value string Yes -

error

Example Json: Minimal | Full
Field Type Required? Default Description
code string Yes -

Machine readable code for this specific error message

message string Yes -

Description of the error

file

Example Json: Minimal | Full

Represents a source file

Field Type Required? Default Description
name string Yes -

The recommended name for the file.

Example: BryzekApidocApiClient.scala

dir string No -

The recommended directory path for the file where appropriate.

Example: com/bryzek/apidoc

contents string Yes -

The actual source code.

generator

Example Json: Minimal | Full

The generator metadata.

Field Type Required? Default Description
key string Yes -

name string Yes -

language string No -

A comma separate list of the programming language(s) that this generator produces

Example: scala

description string No -

attributes [string] No []

The list of attributes that this code generator can use. You can find the full list of available attributes and their descriptions at http://apidoc.me/doc/attributes

healthcheck

Example Json: Minimal | Full
Field Type Required? Default Description
status string Yes -

Example: healthy

invocation

Example Json: Minimal | Full

The result of invoking a generator.

Field Type Required? Default Description
source string Yes -

The actual source code.

deprecated:

Use files instead

files [file] Yes -

A collection of source files

invocation_form

Example Json: Minimal | Full

The invocation form is the payload send to the code generators when requesting generation of client code.

Field Type Required? Default Description
service com.bryzek.apidoc.spec.v0.models.service:0.11.80 Yes -

attributes [attribute] No []

user_agent string No -

Unions

No unions