Forum Discussion

fehguy's avatar
fehguy
Icon for Staff rankStaff
10 years ago
Solved

Introducing SwaggerHub Domains

Hi, today we released Domains, which are reusable components for Swagger.  This allows you to leverage work in a central location, with versioning, publishing, and collaboration functionality.  Read ...
  • RonRatovsky's avatar
    RonRatovsky
    10 years ago

    Hi Ofir,

     

    Thanks for trying out the Domains feature.

     

    Referencing a component in a Domain is done using a full URL reference. The type of reference you used in your sample is not supported by the Swagger Specification itself.

     

    However, to make it easier, we've also introduced an auto-suggest feature that would type in the reference for you. This can be triggered with ctrl+space after the ref declaration.

     

    For a video demonstration, please check out https://youtu.be/6_oGhlj0ym0.

     

     

ofirmgr's avatar
ofirmgr
Occasional Visitor
10 years ago

I coun't get Domain to work.

this is the steps I did:

  • Created new domain
  • Added the following:
parameters:
  skipParam:
    name: "skip"
    in: "query"
    description: "number of items to skip"
    type: "integer"
  • Go back to my API:
  • try add the following:
    get:
      parameters:
        $ref: 'skipParam'
      responses:
        200:
  • got:  ✖ Swagger Error

    The parameters needed to send a valid API call

What am I doing wrong?

  • RonRatovsky's avatar
    RonRatovsky
    Icon for Staff rankStaff
    10 years ago

    Hi Ofir,

     

    Thanks for trying out the Domains feature.

     

    Referencing a component in a Domain is done using a full URL reference. The type of reference you used in your sample is not supported by the Swagger Specification itself.

     

    However, to make it easier, we've also introduced an auto-suggest feature that would type in the reference for you. This can be triggered with ctrl+space after the ref declaration.

     

    For a video demonstration, please check out https://youtu.be/6_oGhlj0ym0.