{"id":20936209,"url":"https://github.com/adzerk/adzerk-api-specification","last_synced_at":"2026-02-02T22:28:26.452Z","repository":{"id":40404287,"uuid":"220276281","full_name":"adzerk/adzerk-api-specification","owner":"adzerk","description":"Kevel OpenAPI specification","archived":false,"fork":false,"pushed_at":"2025-01-21T16:58:56.000Z","size":452,"stargazers_count":5,"open_issues_count":3,"forks_count":3,"subscribers_count":29,"default_branch":"master","last_synced_at":"2025-02-19T15:07:19.931Z","etag":null,"topics":["management"],"latest_commit_sha":null,"homepage":"https://dev.kevel.com","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adzerk.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-07T16:05:11.000Z","updated_at":"2025-01-21T16:58:22.000Z","dependencies_parsed_at":"2023-11-13T23:25:52.308Z","dependency_job_id":"3a718e4f-867e-4fab-bc9b-f0f4b1e180af","html_url":"https://github.com/adzerk/adzerk-api-specification","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adzerk%2Fadzerk-api-specification","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adzerk%2Fadzerk-api-specification/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adzerk%2Fadzerk-api-specification/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adzerk%2Fadzerk-api-specification/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adzerk","download_url":"https://codeload.github.com/adzerk/adzerk-api-specification/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243330259,"owners_count":20274037,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["management"],"created_at":"2024-11-18T22:18:24.200Z","updated_at":"2025-12-28T08:02:04.694Z","avatar_url":"https://github.com/adzerk.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"## Install Instructions\n\nCan use either NPM or Brew (mac) to install:\n\n```sh\n$ npm install @openapitools/openapi-generator-cli -g\n```\n\nor\n\n```sh\n$ brew install openapi-generator\n```\n\nIf you have issues or need upgrade instructions, please visit https://openapi-generator.tech/docs/installation/.\n\n## Releasing\n\nThere are two GHA that will complete publishing both Management SDK and Decision SDK.\nIn order to trigger them a new `release` has to be created on GH releases [page](https://github.com/adzerk/adzerk-api-specification/releases).\n`Draft a new release` and enter the new release tag or pick if from the list of existing tags, target to `master` and `Generate release notes` before hitting `Publish release`.\nValidate on the GH actions [page](https://github.com/adzerk/adzerk-api-specification/actions) that the workflows executed successfully.\n\n## Sample Invocations\n\n### Decision SDK\n\nAll 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.\n\n#### JavaScript\n\nThe 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.\n\n```sh\n$ openapi-generator generate \\\n    -i ./decision/openapi-3.yaml \\\n    -g typescript-fetch \\\n    -o ./build/decision-js/ \\\n    -c ./decision/codegen-config/typescript-fetch.json\n```\n\n#### Java\n\n```sh\n$ openapi-generator generate \\\n    -i ./decision/openapi-3.yaml \\\n    -g java \\\n    -o ./build/decision-java/ \\\n    -c ./decision/codegen-config/java.json\n```\n\n#### Ruby\n\n```sh\n$ openapi-generator generate \\\n    -g ruby \\\n    -i ./decision/openapi-3.yaml \\\n    -o ./build/decision-ruby/ \\\n    -c ./decision/codegen-config/ruby.json\n```\n\n#### Python\n\n```sh\n$ openapi-generator generate \\\n    -g python \\\n    -i ./decision/openapi-3.yaml \\\n    -o ./build/decision-python/ \\\n    -c ./decision/codegen-config/python.json\n```\n\n### Management SDK\n\nNote to maintainers: The openapi-3.yaml file doesn't fully reference all of the\nendpoints and schemas in the individual entity YAML files. For this reason, please make\nsure to update both the individual entity YAML file AND the openapi-3.yaml file when\nmaking changes. Bonus points for linking the 2 with `$ref` so that there is only one\nplace to make changes.\n\n#### JavaScript\n\n```sh\n$ openapi-generator generate \\\n    -i ./management/openapi-3.yaml \\\n    -g typescript-fetch \\\n    -o ./build/mgmt-js/ \\\n    -c ./management/codegen-config/typescript-fetch.json\n```\n\n#### Ruby\n\n```sh\n$ openapi-generator generate \\\n    -g ruby \\\n    -i ./management/openapi-3.yaml \\\n    -o ./build/mgmt-ruby/ \\\n    -c ./management/codegen-config/ruby.json\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadzerk%2Fadzerk-api-specification","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadzerk%2Fadzerk-api-specification","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadzerk%2Fadzerk-api-specification/lists"}