Forum Discussion

ramster's avatar
ramster
New Contributor
8 years ago
Solved

malformed or unreadable swagger supplied

My document looks ok and verifies as a valid YAML/Json However, I get from swaggerhub editor a "malformed or unreadable swagger supplied" this is my api: https://app.swaggerhub.com/api/redramster/...
  • RonRatovsky's avatar
    RonRatovsky
    8 years ago

    Okay, that one was a bit tricky. Under your Employer definition you have:

     

     

        locations:
        type: "array"
        items:  {
          $ref: "/definitions/Location"
        }

     

    It should actually be (notice the extra #):

     

        locations:
        type: "array"
        items:  {
          $ref: "#/definitions/Location"
        }

    That should solve the issue.

    Also, if you want to utilize YAML to the fullest, you can write it all as:

     

        locations:
        type: array
        items: 
          $ref: "#/definitions/Location"
RonRatovsky's avatar
RonRatovsky
Moderator
8 years ago

Okay, that one was a bit tricky. Under your Employer definition you have:

 

 

    locations:
        type: "array"
        items:  {
          $ref: "/definitions/Location"
        }

 

It should actually be (notice the extra #):

 

    locations:
        type: "array"
        items:  {
          $ref: "#/definitions/Location"
        }

That should solve the issue.

Also, if you want to utilize YAML to the fullest, you can write it all as:

 

    locations:
        type: array
        items: 
          $ref: "#/definitions/Location"
  • ramster's avatar
    ramster
    New Contributor
    8 years ago

    gee, that was quick!! :) thanks a lot.

    I wonder why your validator did not point me there and just gave a general error

    • RonRatovsky's avatar
      RonRatovsky
      Moderator
      8 years ago

      That's a good question. I'll open a ticket internally about it so we can track it down.

      • asdfghjhgfds's avatar
        asdfghjhgfds
        Occasional Visitor
        7 years ago

        I'm also having the same problem.  Other swagger validators say there are no error but Swagger Hub shows the "malformed or unreadable swagger supplied" message for the following document

         

        https://app.swaggerhub.com/apis/jamesdbloom/mock-server_api/10.8.

         

        Has there been any progress on why this error is not pointing to the problem?