Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

It's exactly that, but I don't see the issue. API+Docs under a single URL looks like a win for me. It also warrants a new name.
 help



> new name

Swagger was the new old name for the concept


Exactly! Swagger descriptions+GUI[1], HATEOAS[2], and JSONAPI[3] all coming together in jubilous harmony if MCP pulled its head out of the sand, but instead we get the XKCD#927[4] situation.

1: https://swagger.io/docs/specification/v3_0/adding-examples/

2: https://en.wikipedia.org/wiki/HATEOAS

3: https://jsonapi.org

4: https://xkcd.com/927/




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: