---
published: true
layout: post
title: 'API Specifications Update for August 6th, 2021'
image: https://kinlane-productions2.s3.amazonaws.com/algorotoscope-master/birth-of-a-nation-shipping-docks_36331347010_o.jpg
tags:
    - API Specification Update
---
<p><img src="{{ page.image }}" width="45%" align="right" style="padding: 15px;"></p>

<p>I try to stay up to speed with what is happening across the leading API specifications each week. The evolution of <a href="https://www.openapis.org/">OpenAPI</a>, <a href="https://www.asyncapi.com/">AsyncAPI</a>, and <a href="https://json-schema.org/">JSON Schema</a> is important to what I do at Postman, but also to the wider API space. I find it helpful to understand what is happening across each of the API specification communities, and I wanted to also find a way to share what I am seeing with everyone else. Providing a single digest of what is happening, without having to do all the work I am doing each week. While I am sure there is much more going on that I am not tuned into, here is a snapshot of what I see happening.</p>

<h3>Recent Meetings</h3>
<p>These are the meetings that happened this past week:</p>

<ul>
    <li><strong>OpenAPI</strong>
        <ul>
            <li><a href="https://docs.google.com/document/d/19gLkynTLTJnd4bnHr-dCqLh544M2lAlL1VIIQJTEsw0/edit#"><strong>OAI Marketing</strong></a></li>
             <li><a href="https://www.notion.so/dif/HOSPITALITY-TRAVEL-SIG-242105321e1747f8bce776bf634a55b3"><strong>Travel SIG</strong></a></li>
            <li><a href="https://calendar.google.com/event?action=TEMPLATE&tmeid=N2tlZjIwczgwcmQ0bm0zc3E2Mzg3bHE0ZmtfMjAyMTA4MDVUMTUwMDAwWiBjXzBtZzBnZmxqbnYxNTYxbGcxc3BwM21vcXZjQGc&tmsrc=c_0mg0gfljnv1561lg1spp3moqvc%40group.calendar.google.com&scp=ALL"><strong>API Specifications Office Hours</strong></a></li>
        </ul>
    </li>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://github.com/asyncapi/community/issues/43<"><strong>AsyncAPI SIG meeting</strong></a></li>
        </ul>
    </li>
</ul>

<h3>Upcoming Meetings</h3>
<p>These are the upcoming meetings that I am tuned into:

<ul>
    <li><strong>OpenAPI</strong>
        <ul>
            <li><a href="https://docs.google.com/document/d/19gLkynTLTJnd4bnHr-dCqLh544M2lAlL1VIIQJTEsw0/edit#"><strong>OAI Marketing</strong></a></li>
            <li><a href="https://www.notion.so/dif/HOSPITALITY-TRAVEL-SIG-242105321e1747f8bce776bf634a55b3"><strong>Travel SIG</strong></a></li>
            <li><a href=" - https://calendar.google.com/event?action=TEMPLATE&tmeid=N2tlZjIwczgwcmQ0bm0zc3E2Mzg3bH"><strong>API Specifications Office Hours</strong></a></li>
            <li><a href="https://github.com/OAI/OpenAPI-Specification/issues/2672"><strong>Technical Developer Community</strong></a></li>
        </ul>
    </li>
    <li><strong>JSON Schema</strong>
        <ul>
            <li><a href="https://github.com/json-schema-org/community/discussions/34"><strong>JSON Schema Office Hours </strong></a></li>
        </ul>
    </li>
</ul>


<h3>Interesting Issues</h3>
<p>AsyncAPI had some interesting issues to tune into:

<ul>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://github.com/asyncapi/spec/issues/607"><strong>ChannelItem.$ref field deprecation + proposal how to replace it with simpler and more flexible solution #607</strong></a></li>
            <li><a href="https://github.com/asyncapi/spec/issues/606"><strong>Proposal to create new Message Example Object #606</strong></a></li>
            <li><a href="https://github.com/asyncapi/spec/issues/604"><strong>Inconsistency between Message.examples and MessageTrait.examples #604</strong></a></li>
        </ul>
    </li>
</ul>

<h3>Interesting Discussions</h3>
<p>There are some of the interesting conversations:

<ul>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://github.com/asyncapi/community/discussions"><strong>AsyncAPI Conference </strong></a></li>
        </ul>
    </li>
    <li><strong>JSON Schema</strong>
        <ul>
            <li><a href="https://github.com/json-schema-org/community/discussions/18"><strong>Improve the use of JSON Schema in tooling beyond validation #18</strong></a></li>
        </ul>
    </li>    
</ul>

<h3>Interesting Releases</h3>
<p>These are the two interesting releases from this last week:

<ul>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://github.com/asyncapi/java-spring-cloud-stream-template/releases/tag/v0.8.0"><strong>asyncapi/java-spring-cloud-stream-template/releases/tag/v0.8.0 - improve the way functions are generated. </strong></a></li>
        </ul>
    </li>
    <li><strong>JSON Schema</strong>
        <ul>
            <li><a href="https://json-schema.org/blog"><strong>JSON Schema Blog</strong></a></li>
        </ul>
    </li>    
</ul>

<h3>Interesting Blog Posts</h3>
<p>Two very JSON Schema focused blog posts to read:

<ul>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://www.asyncapi.com/blog/json-schema-beyond-validation"><strong>Using JSON Schema Beyond Validation</strong></a></li>
        </ul>
    </li>
    <li><strong>JSON Schema</strong>
        <ul>
            <li><a href="https://json-schema.org/blog/posts/bundling-json-schema-compound-documents"><strong>JSON Schema bundling finally formalised</strong></a></li>
        </ul>
    </li>    
</ul>

<h3>Interesting News</h3>
<p>There was one interesting news article on my radar:

<ul>
    <li><strong>AsyncAPI</strong>
        <ul>
            <li><a href="https://thetokenizer.io/2021/08/02/filecoin-and-hedera-hashgraph-announce-grant-program-to-propel-web3-interoperability/"><strong>Providing Decentralized Storage to Hedera NFTs</strong></a> - Hedera Improvement Proposal 10 (HIP-10) offers an ecosystem standard for NFT metadata. To bolster this new functionality, Filecoin (specifically, the NFT.storage service) enables decentralized storage of the JSON schema containing those NFT properties and multimedia or localization data.</li>
        </ul>
    </li>   
</ul>

<h3>Interesting Tweets</h3>

<h4>OpenAPI</h4>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">🗣 I&#39;m taking my <a href="https://twitter.com/OpenApiSpec?ref_src=twsrc%5Etfw">@OpenApiSpec</a> talk roadshow to the API Specifications Conference 2021 <a href="https://t.co/S5MHa803R7">https://t.co/S5MHa803R7</a></p>&mdash; Maarten Van Hoof 🌈🌈🌈 (@mrtnvh) <a href="https://twitter.com/mrtnvh/status/1422905709251997700?ref_src=twsrc%5Etfw">August 4, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<h4>AsyncAPI</h4>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Bank of New Zealand (BNZ) had a great talk about their decentralized company-wide <a href="https://twitter.com/hashtag/governance?src=hash&amp;ref_src=twsrc%5Etfw">#governance</a> strategy using <a href="https://twitter.com/hashtag/ApacheKafka?src=hash&amp;ref_src=twsrc%5Etfw">#ApacheKafka</a> and <a href="https://twitter.com/hashtag/AsyncAPI?src=hash&amp;ref_src=twsrc%5Etfw">#AsyncAPI</a>...<br><br>See their diagram and watch the free on-demand recording from <a href="https://twitter.com/hashtag/KafkaSummit?src=hash&amp;ref_src=twsrc%5Etfw">#KafkaSummit</a> APAC (<a href="https://t.co/wXO7seHJbD">https://t.co/wXO7seHJbD</a>).<br><br>A few n…<a href="https://t.co/hyLiwuS1hg">https://t.co/hyLiwuS1hg</a></p>&mdash; Kai Wähner (@KaiWaehner) <a href="https://twitter.com/KaiWaehner/status/1422082385508773889?ref_src=twsrc%5Etfw">August 2, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<h4>JSON Schema</h4>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">In the last 24 hours the JSON Schema website has seen...<br>TWO MILLION requests! 😅<br>From 128k unique visitors! 🥳<br><br>👇<br><br>😎We have some rather exciting news to announce today too!</p>&mdash; JSON Schema (@jsonschema) <a href="https://twitter.com/jsonschema/status/1423550528097763328?ref_src=twsrc%5Etfw">August 6, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<h3>Interesting Videos</h3>
<p></p>One interesting video you should be watching:</p>

<iframe width="560" height="315" src="https://www.youtube.com/embed/nMGcq2_UGvg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

<h3>Conclusion</h3>
<p>This was my second attempt at doing this type of summary. I will also be posting a little about the process I am using to make this post happen. I will be looking to evolve my approach, and of course, if there is anything missing from my summary of what is going on in the world of API specifications, please let me know! As part of this process I am working to get folks behind the meetings, discussions, and other goings on to be more public about what they are doing so I have a URL to share. Once I get a hang of regular updates for these three specs I will consider adding GraphQL and gRPC. I will be publishing this to the API Evangelist each week (time allowing), and featuring the latest one on the home page. I am also working on updating the home page of <a href="https://api.specificationtoolbox.com/">the API Specification Toolbox</a> to showcase how you can learn, implement, and contribute to each of the specifications—-once I have up, I will link to more from this regularly summary. My goal is to provide a single place everyone can go to get involved within the communities for each of the API specifications, but also stay up to speed on what is going on each week.</p>