IT35844: RETRIEVING THE YAML FORMAT SWAGGER DOCUMENT USING ADMIN REST API RESULTS IN HTTP 500 ERROR

APAR status

• Closed as program error.

Error description

• When the user creates their REST API using a swagger document
  in YAML format, and tries to retrieve the swagger
  document
  using the ACE administrative REST API a parsing
  exception occurs :
  
   curl
  http://localhost:7600/apiv2/rest-apis/{rest api name}/document
  
  -----------------------------
  HTTP 500
  "text": "BIP5719E: A
  JSON parsing error occurred. A message that is not a valid JSON
  message was found in the input bit stream. ",
  "detailedText":
  "This error was reported by the JSON parser at line 3, column
  1, and is typically the result of a message that does not
  comply with the JSON specification.
  
  -----------------------------
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  All users of App Connect Enterprise V11.0 using REST Admin API
  to retrieve swagger document
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  When a REST API project is created using a swagger document in
  YAML format then  retrieving the swagger definition using
  administrative REST API results in parsing  exception  as below
  :
  
   curl  http://localhost:7600/apiv2/rest-apis/{rest api
  name}/document
  
  -----------------------------
  HTTP 500
  "text": "BIP5719E: A JSON parsing error occurred. A message that
  is not a valid JSON message was found in the input bit stream.
  ",
  "detailedText": "This error was reported by the JSON parser at
  line 3, column 1, and is typically the result of a message that
  does not
  comply with the JSON specification.
  
  -----------------------------
  

Problem conclusion

• Product has been modified such that it correctly returns the
  swagger document defined in YAML format.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v11.0      11.0.0.12
  
  The latest available maintenance can be obtained from:
  http://www-01.ibm.com/support/docview.wss?rs=849&uid=swg27006041
  
  If the maintenance level is not yet available,information on
  its planned availability can be found on:
  http://www-1.ibm.com/support/docview.wss?rs=849&uid=swg27006308
  ---------------------------------------------------------------
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  APP CONNECT ENT

• Fixed component ID

  5724J0550

Applicable component levels