6 ms·
Introducing the Open API Initiative
- autotune 11y agoRelevant XKCD: https://xkcd.com/927/ https://xkcd.com/927/
- msoad 11y agoExcept this is not a new standard. OAI is swagger, converted into a more open standard than before.
- Retra 11y agoRelevant dictionary: trite adjective (of a remark, opinion, or idea) overused and consequently of little import; lacking originality or freshness.
- deleted 11y ago[deleted]
- mchahn 11y agoI'm sorry to be negative, but the moment I saw this article I knew I'd see a reference to this cartoon. I assume 98% of HN readers have seen it (too) many times.
- joshdotsmith 11y agoHow does this compare to JSON API? http://jsonapi.org/ http://jsonapi.org/ Is this a competing standard? I'm getting fairly nervous about the rise of competing "standards" with APIs.
- wise_young_man 11y agoI'm less familiar with JSON API, but at first glance it looks like a standard around JSON response bodies for APIs. Swagger's standard API definition is external of your actual API responses and is used primarily for API docs and can be used for auto generating API client libraries/SDKs. Here's an example: https://github.com/OAI/OpenAPI-Specification/blob/master/examples/v2.0/json/petstore.json https://github.com/OAI/OpenAPI-Specification/blob/master/exa...
- Randgalt 11y agoDo API docs actually provide much benefit in practice? Does anyone actually use Javadocs, for example? The problem with documentation at this level is that it's too low level. It useful, maybe, as a quick reference once you already know the project.