Hacker News Reader

HNHacker News

Top New Best Ask Show Jobs

Comment by andybak | Hacker News Reader

Parent Full thread

andybak·

In which case the post title is misleading and should be edited. I'm flagging this.

View on HN

Hey, just clarify the case. You can directly read Swagger or OpenAPI Specification (OAS) files.

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.

Fair 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.

Nobody 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.

That'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.

HTTP 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.

Still looks flagged to me...would be a bummer for someone's Show HN to get flagged down due to a misunderstanding.

Don't flag yet. OP replied

Reply on news.ycombinator.com