<story><title>API Discovery: Can we do better?</title><url>https://blog.apis.guru/api-discovery-can-we-do-better-2336706d5407</url></story><parent_chain></parent_chain><comment><author>psadauskas</author><text>It sounds like what you&amp;#x27;re describing is very similar to Hydra[1], which builds upon JSON-LD[2], which builds upon schema.org.&lt;p&gt;JSON-LD provides a vocabulary (schema) for linking various documents together, so you can for example link a blog post document directly to its author. Hydra then provides a vocabulary that lets you describe how to fetch that author document, what fields are required to create a new author object, and how to update the blog post to instead link to that new author. In this case, both &amp;quot;author&amp;quot; and &amp;quot;blog post&amp;quot; can be their respective schema.org documents.&lt;p&gt;[1]: &lt;a href=&quot;http:&amp;#x2F;&amp;#x2F;www.hydra-cg.com&amp;#x2F;&quot; rel=&quot;nofollow&quot;&gt;http:&amp;#x2F;&amp;#x2F;www.hydra-cg.com&amp;#x2F;&lt;/a&gt;
[2]: &lt;a href=&quot;http:&amp;#x2F;&amp;#x2F;json-ld.org&amp;#x2F;&quot; rel=&quot;nofollow&quot;&gt;http:&amp;#x2F;&amp;#x2F;json-ld.org&amp;#x2F;&lt;/a&gt;</text></comment>
<story><title>API Discovery: Can we do better?</title><url>https://blog.apis.guru/api-discovery-can-we-do-better-2336706d5407</url></story><parent_chain></parent_chain><comment><author>oneweekwonder</author><text>I wonder if the author knows about Swagger specs; They also started the OpenAPI initiative[0].&lt;p&gt;I now have wrapped a couple of API&amp;#x27;s in swagger and using swagger-ui to create beautiful interactive api docs for users.&lt;p&gt;Moving forward I&amp;#x27;m going to wrap most of our legacy systems around a swagger spec&amp;#x27;ed API and discontinue any alternative access to these systems as time goes by.&lt;p&gt;[0]: &lt;a href=&quot;http:&amp;#x2F;&amp;#x2F;swagger.io&amp;#x2F;introducing-the-open-api-initiative&amp;#x2F;&quot; rel=&quot;nofollow&quot;&gt;http:&amp;#x2F;&amp;#x2F;swagger.io&amp;#x2F;introducing-the-open-api-initiative&amp;#x2F;&lt;/a&gt;</text></comment>