/adzerk-api-specification

Kevel OpenAPI specification

Install Instructions

Can use either NPM or Brew (mac) to install:

$ npm install @openapitools/openapi-generator-cli -g

or

$ brew install openapi-generator

If you have issues or need upgrade instructions, please visit https://openapi-generator.tech/docs/installation/.

Sample Invocations

Decision SDK

All of the following commands are meant to be run from within their respective language-specific SDK repositories. In the future, there will be a way to trigger those updates from this repository.

JavaScript

The JavaScript generator is currently the only special case. We specificially route all of the generated code to the generated folder so that it's clear exactly what is generated and what isn't.

$ openapi-generator generate \
    -i ./decision/openapi-3.yaml \
    -g typescript-fetch \
    -o ./build/decision-js/ \
    -c ./decision/codegen-config/typescript-fetch.json

Java

$ openapi-generator generate \
    -i ./decision/openapi-3.yaml \
    -g java \
    -o ./build/decision-java/ \
    -c ./decision/codegen-config/java.json

Ruby

$ openapi-generator generate \
    -g ruby \
    -i ./decision/openapi-3.yaml \
    -o ./build/decision-ruby/ \
    -c ./decision/codegen-config/ruby.json

Python

$ openapi-generator generate \
    -g python \
    -i ./decision/openapi-3.yaml \
    -o ./build/decision-python/ \
    -c ./decision/codegen-config/python.json

Management SDK

Note to maintainers: The openapi-3.yaml file doesn't fully reference all of the endpoints and schemas in the individual entity YAML files. For this reason, please make sure to update both the individual entity YAML file AND the openapi-3.yaml file when making changes. Bonus points for linking the 2 with $ref so that there is only one place to make changes.

JavaScript

$ openapi-generator generate \
    -i ./management/openapi-3.yaml \
    -g typescript-fetch \
    -o ./build/mgmt-js/ \
    -c ./management/codegen-config/typescript-fetch.json

Ruby

$ openapi-generator generate \
    -g ruby \
    -i ./management/openapi-3.yaml \
    -o ./build/mgmt-ruby/ \
    -c ./management/codegen-config/ruby.json