Forum Discussion

ramster's avatar
ramster
New Contributor
8 years ago

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
Staff

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
    Staff
    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
      8 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?