Urgent.News

What's breaking now, across thousands of outlets.

More in Tech

Why Is the Swagger Petstore Example a Bad REST API Design?

TL;DR The Swagger Petstore is useful for demonstrating OpenAPI, but it is a poor REST design reference. It mixes singular and plural resource names, puts action verbs in URLs, uses incorrect HTTP…

  • Swagger Petstore mixes singular and plural resource names
  • Uses action verbs in URLs for endpoints
  • Returns incorrect HTTP status codes and non-standard errors

More from Wednesday 2 September →