What does the "Unrecognized token openapi" error mean when using OpenAPI Generator with OpenAPI 3.0?

Question

I have written an API definition in the OpenAPI 3.0 format (https://swagger.io/docs/specification/basic-structure/). Now I'm trying to generate Java Spring objects as I was previously doing with a Swagger 2.0 definition and its associated Maven plugin.

So far, I have a basic API definition that begins with:

openapi: 3.0.0 info: title: Demo API description: This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification). version: 0.0.1

In my pom.xml file I have added:

<dependency>
  <groupId>org.openapitools</groupId>
  <artifactId>openapi-generator-cli</artifactId>
  <version>3.3.3</version>
</dependency>

But when executing mvn install, I get this error:

com.fasterxml.jackson.core.JsonParseException: Unrecognized
     token 'openapi': was expecting ('true', 'false' or 'null')
     at [Source: definition\DEFINITION.yml; line: 1, column: 9]

Does anyone know where the problem is?

Is this the actual indentation of your definition.yml or just copy-paste formatting issues? The indentation is wrong - info must be on the same level as openapi. Paste your YAML into editor.swagger.io to make sure the syntax is correct. — Helen
– Helen, Commented Nov 19, 2018 at 8:14
this is just a copy-paste. My yaml file is correct and no error is displayed when edited in Swagger editor. But it looks like "openapi" tag is not recognise. — vpa
– vpa, Commented Nov 20, 2018 at 14:29
This is late and probably wrong, but maybe you should be using <artifactId>openapi-generator-maven-plugin</artifactId> instead of the CLI jar? — chrisinmtown
– chrisinmtown, Commented May 1, 2019 at 18:47
I was getting same exception with openapi spec 3.0.0 and openapi-generator-maven-plugin version 5.10. Upgrading openapi-generator-maven-plugin to version 5.2.1 resolved the issue. — Akshay Joshi
– Akshay Joshi, Commented Sep 29, 2021 at 12:05

Gaurav Jeswani · Accepted Answer · 2021-12-11 17:47:45Z

8

After a lot for hit and try I found that issue was with my Swagger file. In that url was not a correct URL. It was something like /api (url without host domain).

OpenAPI generator could have given a better error message. Anyways placing some valid url, allowed me to generate the code.

answered Dec 11, 2021 at 17:47

Gaurav Jeswani

4,6186 gold badges30 silver badges53 bronze badges

Sign up to request clarification or add additional context in comments.

Comments

wh81752 · Accepted Answer · 2022-08-16 08:16:05Z

2

Please change generator plugin and use https://openapi-generator.tech/docs/plugins, i.e.

<plugin>
   <groupId>org.openapitools</groupId>
   <artifactId>openapi-generator-maven-plugin</artifactId>
   <version>6.0.0</version>
   <executions>...</executions>
</plugin>

and my best bet is that it works flawless.

answered Aug 16, 2022 at 8:16

wh81752

9169 silver badges16 bronze badges

Comments

blackr1234 · Accepted Answer · 2022-09-22 07:19:49Z

2

For me, it's the folder path that has space in it causing this error.

answered Sep 22, 2022 at 7:19

blackr1234

1,51415 silver badges25 bronze badges

Comments

Jonas · Accepted Answer · 2021-08-23 07:40:18Z

1

I had the same problem using io.swagger.codegen.v3.swagger-codegen-maven-plugin and windows (works fine on MacOS - so it couldn't have been a syntax issue).

Upgrading to most recent plugin version did fix the error (3.0.27 at the time of writing).

answered Aug 23, 2021 at 7:40

Jonas

5344 silver badges7 bronze badges

Comments

Jason Capriotti · Accepted Answer · 2021-11-10 17:20:25Z

1

I received a similar error using the CLI version of OpenAPI Generator. Based on this issue/comment, I believe any validation issue in a YAML spec will trigger the generator to assume the file is JSON.

At least that is what was happening with my file... sadly, I had to use a different tool to validate the YAML, and then OpenAPI Generator worked.

answered Nov 10, 2021 at 17:20

Jason Capriotti

2,0892 gold badges21 silver badges33 bronze badges

Comments

matze999 · Accepted Answer · 2021-06-01 14:00:00Z

0

I ran into the same issue (i need to mention that this occurs only on windows. The same code works fine under linux). While i do not have a "solution"n the workaround which works for me is to set:

validateSpec = false

So something like

generatorName = "typescript-angular"
validateSpec = false
inputSpec = "${myInputSpec}".toString()
outputDir = "${generatedCodeDir}".toString()

answered Jun 1, 2021 at 14:00

matze999

4811 gold badge6 silver badges19 bronze badges

Comments

julemand101 · Accepted Answer · 2022-01-12 09:42:54Z

0

I'm currently working on openapi-generator-maven-plugin to generate Java classes from an OpenAPI JSON schema.

The errors looks like a syntax problem. So first make sure your schema is syntactically correct and looks like this:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo API",
    "description": "This is a basic REST API implementing the [Open API Specification](https://en.wikipedia.org/wiki/OpenAPI_Specification).",
    "version": "0.0.1"
  },
  # Schema definition goes here
}

edited Jan 12, 2022 at 9:42

julemand101

31.7k5 gold badges59 silver badges55 bronze badges

answered Nov 20, 2018 at 15:34

R4FT3R

1172 silver badges9 bronze badges

2 Comments

chrisinmtown Over a year ago

Why should @vpa dumb down his perfectly valid YAML into JSON?

Oliver Gondža Over a year ago

@chrisinmtown, It makes no logical sense for the user to do that. But since the exception indicates it is trying to use JSON parser to consume YAML input, I can see how this might workaround the issue.

Abhishek · Accepted Answer · 2024-05-15 05:00:04Z

0

Faced similar issue with io.swagger.codegen.v3.swagger-codegen-maven-plugin v3.0.35 on windows. It got resolved on updating the dependency to v3.0.55 (latest at time of writing)

answered May 15, 2024 at 5:00

Abhishek

1

Collectives™ on Stack Overflow

What does the "Unrecognized token openapi" error mean when using OpenAPI Generator with OpenAPI 3.0?

8 Answers 8

Comments

Comments

Comments

Comments

Comments

Comments

2 Comments

Comments

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

8 Answers 8

Comments

Comments

Comments

Comments

Comments

Comments

2 Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Related