Skip to main content

You are not logged in. Your edit will be placed in a queue until it is peer reviewed.

We welcome edits that make the post easier to understand and more valuable for readers. Because community members review edits, please try to make the post substantially better than how you found it, for example, by fixing grammar or adding additional resources and hyperlinks.

3
  • 2
    You can calibrate this to precisely meet your needs: /stores could include one thumbnail picture, and then /stores/{storesId} or /stores/{storeId}/pictures could provide every available picture, with that link included in your first response. Commented Jan 11, 2017 at 18:40
  • You're right. Different resources. @Gaurav what you wrote is exactly how i'm going. I was hanging too much on the fact that my swagger specification would have two very close definitions but I guess that's ok. Commented Jan 12, 2017 at 14:11
  • 1
    @RodrigoLira - I think that you've identified a key point in your comment. Do not conflate a clean swagger spec with a well designed API. Commented Jan 13, 2017 at 13:03