3 ms·

> Show me a REST API! https://petstore.swagger.io/ https://petstore.swagger.io/ is an example. Quite a few companies use a similar format to document their pu

• jonahx 6y ago
  Where is the media type definition? Where is the single entry endpoint or the response links driving application state?
  • BadInformatics 6y ago
    `uploadImage`, `createWithArray` and `createWithList` also read suspiciously like RPC endpoint names. Not that one should depend on such URLs having meaning in a REST system, but this is arguably more egregious than the SocialSite API (http://web.archive.org/web/20090123123719/http://wikis.glassfish.org/socialsite/Wiki.jsp?page=FinalizeRESTAPI http://web.archive.org/web/20090123123719/http://wikis.glass...) that Roy Fielding was tearing into in the blog post linked upthread.
• sunaurus 6y ago
  This is an excellent example of how the word "REST" in its common use tells you absolutely nothing about an API. This API certainly does not look like a Fielding-REST-API, and it doesn't even look like a programming-blog-REST-API (in my experience, bloggers just like to use "REST" to mean "HTTP + JSON + no RPC"). Why can't we just call this an "HTTP API"?