d-yoshi/redmine-openapi

Unofficial OpenAPI specification for the Redmine API

Unofficial OpenAPI specification for the Redmine API

Overview

This OpenAPI specification file was created by manual scraping the official api docs and experimentation.

Docs

Redmine: 5.0.x
OpenAPI: 3.0.3

https://d-yoshi.github.io/redmine-openapi/

Reference

Redmine API Official Developer Guide

redmine-openapi's Issues

Excellent OpenAPI Redmine

You have done a wonderful job on the OpenAPI specification for redmine. This will allow developers to automatically generate clients for different programming languages.

Please tell me, is there a chance that this specification will become the main one for redmine?

The current Redmine REST API specification looks outdated and does not have an overall clear open specification as an opensource solution.

Cannot generate openapi client with swagger/openapi-generator

using maven

            <!-- https://mvnrepository.com/artifact/org.openapitools/openapi-generator-maven-plugin -->
            <plugin>
               <groupId>org.openapitools</groupId>
               <artifactId>openapi-generator-maven-plugin</artifactId>
               <version>7.0.0</version>
               <executions>
                  <execution>
                     <goals>
                        <goal>generate</goal>
                     </goals>
                     <configuration>
                        <inputSpec>https://d-yoshi.github.io/redmine-openapi/openapi.yml</inputSpec>
                        <generatorName>java</generatorName>
                        <library>resttemplate</library>
                        <apiPackage>${openApiPackage}</apiPackage>
                        <modelPackage>${openApiModelPackage}</modelPackage>
                        <useSpringBoot3>true</useSpringBoot3>
                        <generateApis>true</generateApis>
                        <generateApiDocumentation>false</generateApiDocumentation>
                        <generateApiTests>true</generateApiTests>
                        <generateModels>true</generateModels>
                        <generateModelDocumentation>true</generateModelDocumentation>
                        <generateModelTests>false</generateModelTests>
                        <generateSupportingFiles>true</generateSupportingFiles>
                        <legacyDiscriminatorBehavior>false</legacyDiscriminatorBehavior>
                        <configOptions>
                           <delegatePattern>true</delegatePattern>
                           <additionalModelTypeAnnotations>@lombok.Data</additionalModelTypeAnnotations>
                        </configOptions>
                     </configuration>
                  </execution>
               </executions>
            </plugin>

I am getting on the generated classes this compile errors:

SearchFormatGetAttachmentsParameter

OneOfstringinteger cannot be resolved to a type SearchFormatGetAttachmentsParameter.java

so looks like the oneOf definition is still not supported by openapi-generator (since nearly over 3y).
So do you have an idea how to fix this generation issue?