Using ^%REST to Create a Service - Correct OpenAPI 2.0 version was not specified

Question

Question

Update - I answered my own question, so I'll just leave this here in case it can help someone.

Hi All

I'm following the tutorial Creating and Editing REST Services and have reached the step Using ^%REST to Create a Service and have encountered an error.

Here is grab of the terminal command:

PARISCONNECT>do ^%REST
 
REST Command Line Interface (CLI) helps you CREATE or DELETE a REST application.
Enter an application name or (L)ist all REST applications (L): PcConRest
REST application not found: PcConRest
Do you want to create a new REST application? Y or N (Y): Y
 
File path or absolute URL of a swagger document.
If no document specified, then create an empty application.
OpenAPI 2.0 swagger: e:\temp\schema.json
OpenAPI 2.0 swagger document: e:\temp\schema.json
Confirm operation, Y or N (Y): Y
 
-----Creating REST application: PcConRest-----
Error creating application
ERROR #8738: Correct OpenAPI 2.0 version was not specified: . <$.swagger>
  > ERROR #5490: Error running generator for method '%OnCompile:PcConRest.spec'
ERROR: %REST.Spec.cls(%OnCompile) of generated code compiling subclass 'PcConRest.spec'
    > ERROR #5030: An error occurred while compiling class 'PcConRest.spec'
 
Enter an application name or (L)ist all REST applications (L):

The error produced is Correct OpenAPI 2.0 version was not specified, and I have downloaded the OpenAPI-Specification v2.0 schema from here - this location was taken directly from the tutorial document referenced above. Where can I find the correct version, or am I doing something wrong?

Cheers

Andy

Product version: IRIS 2021.1

$ZV: IRIS for Windows (x86-64) 2021.2.1 (Build 654U) Fri Mar 18 2022 06:09:35 EDT

Discussion (4)1

Log in or sign up to continue

Andy Stobirski · Jan 21

UPDATE

I was making a mistake - the file I was using was is the empty schema. I needed something that contains valid content, such as the example given here.

When used that file, the Rest Command Line Interface Worked correctly.

1 0

score 0 · Answer 1 · 2024-01-21T02:46:33-05:00

Hello @Andy Stobirski

The property "swagger" is an mandatory field and the value should be string value "2.0" not even integer 2 or anything other than "2.0". If you defined the mandatory fields then it should work.

score 0 · Answer 2 · 2024-01-21T07:11:13-05:00

Hi Ashok, thanks for your reply and link, which was very interesting.

I have checked the swagger document and it appears to contain the correct value though:

   "properties": {
        "swagger": {
            "type": "string",
            "enum": [
                "2.0"
            ],
            "description": "The Swagger version of this document."
        }
   }

score 0 · Answer 3 · 2024-01-21T11:29:54-05:00

Robert Cemper · Jan 21

👍 SUPER 💪

0 0