2 ms·
> Swagger ... is not suited to describing hypermedia APIs Why is that? It wouldn't force/guide you to create a hypermedia APIs by default, but it could be used
by Flenser 12y ago
> Swagger ... is not suited to describing hypermedia APIs
Why is that? It wouldn't force/guide you to create a hypermedia APIs by default, but it could be used to document one couldn't it?
- gamache 12y agoAt least the last time I looked at Swagger, it was very much URL/endpoint-focused. Hyperlinks, while documentable, are not first-class citizens. In a real hypermedia-driven API, you want to document the links, not the URLs, as the API users will be using these named links, and not constructing URLs, to access functionality.