swagger-api / swagger-api/swagger-codegen
Codegen unable to successfully build TeamWork Cloud REST API
Nobody has claimed this yet.
- Dominant language
- Mustache
- Stars
- 17.8k
- Forks
- 6k
- PR merge metrics
- No merged PRs in 30d
Description
When using the code generator, TeamWork Cloud REST API (link below) will generate the models/api, however they are in a broken state. Some models fail to generate, and others simply cannot be used to deserialize messages received (java.lang.IllegalStateException: Expected STRING but was BEGIN_ARRAY at path $.ldp:contains[0]).
https://osmc.nomagic.com/19.0sp4/swagger/index.html
When generating, I use the following command
java -jar swagger-codegen-cli-3.0.35.jar generate -i https://osmc.nomagic.com/19.0sp4/twc-rest-swagger.json -l java -o TWC
I was hoping someone might be able to give a workaround to this issue.
Thanks
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the generation command with the TeamWork Cloud Swagger document and Java target, then inspect the generated models and the deserialization failure at $.ldp:contains[0]. Compare the models that fail to generate with those that cannot deserialize, and consider the issue addressed when a concrete workaround or reproducible generator fix is identified.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java, openapi
- Domain
- api, tooling
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100