IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

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

Temporary fix

Comments

APAR Information

  • APAR number

    IT35844

  • Reported component name

    APP CONNECT ENT

  • Reported component ID

    5724J0550

  • Reported release

    B00

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-02-09

  • Closed date

    2021-03-22

  • Last modified date

    2021-03-22

  • 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

[{"Line of Business":{"code":"LOB36","label":"IBM Automation"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSDR5J","label":"IBM App Connect Enterprise"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"B00"}]

Document Information

Modified date:
23 March 2021