Skip to content

adzerk/adzerk-api-specification

Folders and files

NameName
Last commit message
Last commit date
Aug 29, 2023
Aug 15, 2023
Dec 5, 2024
Nov 7, 2019
Dec 5, 2024
Nov 13, 2023
Nov 6, 2023
Aug 14, 2023
Jun 4, 2024
Feb 22, 2024

Repository files navigation

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