4 ms·
OK. Unflagged. So this is about web APIs? I dislike that the broad term "API" has started to be used as shorthand for "HTTP API" (and probably REST-ish HTTP AP
by andybak 2y ago
OK. Unflagged.
So this is about web APIs? I dislike that the broad term "API" has started to be used as shorthand for "HTTP API" (and probably REST-ish HTTP APIs specifically). It wastes people's time trying to figure out if something is of interest to them. Not everyone in tech is building web apps.
- goargp 2y agoFair point. I think the title can be more accurate by changing API into "REST API". Since I cannot edit the title as of now, I hope mod could change the title to be more accurate. For more context, this tool can generate an MCP Server from an OpenAPI/Swagger file that describes a REST API. This does not include SOAP APIs, GraphQL, or other APIs that use the HTTP protocol.
- imtringued 2y agoNobody on this planet builds REST APIs. It's not worth explaining what REST actually means. It is a waste of time. HTTP API is the correct phrase.
- andybak 2y agoThat's why I tend to say "REST-ish" because there is a difference between those and things like GraphQL or RPC style APIs which can also use HTTP.
- koakuma-chan 2y agoHTTP APIs are APIs that rely on HTTP semantics (so not GraphQL). And the only difference between what you call "REST-ish" and "RPC-style" is "POST /messages" vs "POST /createMessage" anyway.
- epaga 2y agoStill looks flagged to me...would be a bummer for someone's Show HN to get flagged down due to a misunderstanding.
- deleted 2y ago[deleted]