---
published: true
layout: post
title: 'API Specifications Update for September 8th, 2021'
image: https://kinlane-productions2.s3.amazonaws.com/algorotoscope-master/uncle-sam-cloks-many-of-them.jpg
tags:
    - API Specification Update
---
<p><img src="{{ page.image }}" width="45%" align="right" style="padding: 15px;"></p>

<p>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. Each week I spend time to create 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 what I see as the  snapshot of what I see happening across the API specifications.</p>

<h3>Recent Meetings</h3>
<ul>
<li><a href="https://github.com/OAI/OpenAPI-Specification/issues/2687" target="_blank" style="color: #000;">Open Community (TDC) Meeting, Thursday 02 September 2021 · Issue #2687 </a> - Last weeks OpenAPI TDC meeting.</li>
<li><a href="https://github.com/json-schema-org/community/discussions/34" target="_blank" style="color: #000;">Office Hours · Discussion #34</a> - Last weeks JSON Schema office hours.</li>
<li><a href="https://github.com/api-specification-toolbox/toolbox/issues/138" target="_blank" style="color: #000;">API Specification Office Hours · Issue #138</a> - This weekly API specification meeting.</li>
</ul>
<h3>Upcoming Meetings</h3>
<ul>
<li><a href="https://github.com/OAI/OpenAPI-Specification/issues/2700" target="_blank" style="color: #000;">Open Community (TDC) Meeting, Thursday 09 September 2021 · Issue #2700</a> - This weeks OpenAPI TDC meeting.</li>
<li><a href="https://github.com/json-schema-org/community/discussions/34" target="_blank" style="color: #000;">Office Hours · Discussion #34</a> - This next week's JSON Schema public office hours.</li>
<li><a href="https://github.com/api-specification-toolbox/toolbox/issues/138" target="_blank" style="color: #000;">API Specification Office Hours · Issue #138</a> - This week's API specification office hours.</li>
<li><a href="https://www.asyncapi.com/" target="_blank" style="color: #000;">AsyncAPI Initiative for event-driven APIs</a> - </li>
</ul>
<h3>Interesting Issues</h3>
<ul>
<li><a href="https://github.com/OAI/OpenAPI-Specification/issues/2703" target="_blank" style="color: #000;">Errata and/or Spec Clarification Required for Security Scheme Object (OAS 3.0 and OAS 3.1) · Issue #2703 · OAI/OpenAPI-Specification</a> - </li>
<li><a href="https://github.com/OAI/OpenAPI-Specification/issues/2701" target="_blank" style="color: #000;">Does the date format not support the nanosecond format? · Issue #2701 · OAI/OpenAPI-Specification</a> - </li>
<li><a href="https://github.com/asyncapi/spec/issues/618" target="_blank" style="color: #000;">Proposal to solve publish/subscribe confusion · Issue #618 · asyncapi/spec</a> - </li>
</ul>
<h3>Interesting Discussions</h3>
<ul>
<li><a href="https://github.com/OAI/OpenAPI-Specification/discussions/2705" target="_blank" style="color: #000;">How should one cite the OpenAPI specification? · Discussion #2705 · OAI/OpenAPI-Specification</a> - </li>
<li><a href="https://github.com/OAI/OpenAPI-Specification/discussions/2693" target="_blank" style="color: #000;">How should we determine the prioritization of work? · Discussion #2693 · OAI/OpenAPI-Specification</a> - </li>
<li><a href="https://github.com/OAI/OpenAPI-Specification/discussions/2695" target="_blank" style="color: #000;">Special Interest Groups (SIGs) · Discussion #2695 · OAI/OpenAPI-Specification</a> - </li>
<li><a href="https://github.com/json-schema-org/community/discussions/44" target="_blank" style="color: #000;">Properties, members, items, and elements · Discussion #44 · json-schema-org/community</a> - </li>
<li><a href="https://github.com/json-schema-org/community/discussions/48" target="_blank" style="color: #000;">How to manage meta-schema updates between draft releases · Discussion #48 · json-schema-org/community</a> - </li>
</ul>
<h3>Interesting Releases</h3>
<ul>
<li><a href="https://github.com/asyncapi/modelina/releases/tag/v0.29.0" target="_blank" style="color: #000;">Release v0.29.0 · asyncapi/modelina</a> - csharp enum rendering associated values</li>
<li><a href="https://github.com/asyncapi/parser-js/releases/tag/v1.9.0" target="_blank" style="color: #000;">Release v1.9.0 · asyncapi/parser-js</a> - added traits() and hasTraits() functions </li>
<li><a href="https://github.com/asyncapi/avro-schema-parser/releases/tag/v0.4.0" target="_blank" style="color: #000;">Release v0.4.0 · asyncapi/avro-schema-parser</a> - parse Avro name field to custom x-parser-schema-id</li>
<li><a href="https://github.com/asyncapi/parser-js/releases/tag/v1.8.0" target="_blank" style="color: #000;">Release v1.8.0 · asyncapi/parser-js</a> - expose parser options as a seperate type</li>
</ul>
<h3>Interesting Blog Posts</h3>
<ul>
<li><a href="https://www.asyncapi.com/blog/openapi-vs-asyncapi-burning-questions" target="_blank" style="color: #000;">AsyncAPI vs OpenAPI: Answers to Your Burning Questions About the Two Most Popular API Specs | AsyncAPI Initiative for event-driven APIs</a> - AsyncAPI and OpenAPI are different ways of defining application programming interfaces (APIs), also commonly known as API specs. Both API specs serve a crucial role in defining and governing distributed computing systems, but AsyncAPI and OpenAPI are used for different styles of integration</li>
</ul>

<h3>Interesting Tweets</h3>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Join RedHat&#39;s Hugo Guerrero at ASC 2021! &quot;Event-driven APIs &amp; Schema governance for Apache Kafka&quot; <a href="https://twitter.com/hguerreroo?ref_src=twsrc%5Etfw">@hguerreroo</a> <a href="https://twitter.com/RedHat?ref_src=twsrc%5Etfw">@RedHat</a> <a href="https://twitter.com/hashtag/APIs?src=hash&amp;ref_src=twsrc%5Etfw">#APIs</a> <a href="https://twitter.com/hashtag/OpenAPI?src=hash&amp;ref_src=twsrc%5Etfw">#OpenAPI</a> <a href="https://twitter.com/hashtag/OSS?src=hash&amp;ref_src=twsrc%5Etfw">#OSS</a> <a href="https://twitter.com/hashtag/REST?src=hash&amp;ref_src=twsrc%5Etfw">#REST</a> <a href="https://twitter.com/hashtag/APISpecs2021?src=hash&amp;ref_src=twsrc%5Etfw">#APISpecs2021</a> <a href="https://t.co/pp4F5eUjzG">https://t.co/pp4F5eUjzG</a> <a href="https://t.co/kPsDPgb7Uh">pic.twitter.com/kPsDPgb7Uh</a></p>&mdash; OpenAPI Spec (@OpenApiSpec) <a href="https://twitter.com/OpenApiSpec/status/1433763958763184128?ref_src=twsrc%5Etfw">September 3, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Share and highlight anything inside your API documentation. 🔗✨<br><br>Asked by many of our users, you can now share and highlight anything in your docs with just a click. The selected element will be highlighted following your color theme.<br><br>Give it a try: <a href="https://t.co/Sg4642Gb06">https://t.co/Sg4642Gb06</a> <a href="https://t.co/R8BSvQrww2">pic.twitter.com/R8BSvQrww2</a></p>&mdash; Bump (@bump_hq) <a href="https://twitter.com/bump_hq/status/1435614384781504518?ref_src=twsrc%5Etfw">September 8, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">I just published Introduction to OpenAPI with Ballerina - An introduction to OpenAPI and client generation using <a href="https://twitter.com/ballerinalang?ref_src=twsrc%5Etfw">@ballerinalang</a> <a href="https://twitter.com/hashtag/ballerinalang?src=hash&amp;ref_src=twsrc%5Etfw">#ballerinalang</a> <a href="https://twitter.com/hashtag/openapi?src=hash&amp;ref_src=twsrc%5Etfw">#openapi</a> <a href="https://twitter.com/hashtag/Microservices?src=hash&amp;ref_src=twsrc%5Etfw">#Microservices</a> <a href="https://twitter.com/hashtag/CloudNative?src=hash&amp;ref_src=twsrc%5Etfw">#CloudNative</a> <a href="https://twitter.com/hashtag/Opensource?src=hash&amp;ref_src=twsrc%5Etfw">#Opensource</a> <a href="https://t.co/eonAPwI37W">https://t.co/eonAPwI37W</a></p>&mdash; Anupama Pathirage (@anupama_pathira) <a href="https://twitter.com/anupama_pathira/status/1434210773278998528?ref_src=twsrc%5Etfw">September 4, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr"><a href="https://twitter.com/hashtag/AsyncAPI?src=hash&amp;ref_src=twsrc%5Etfw">#AsyncAPI</a> continues to get traction - reflecting its position, as part of Event-Driven APIs, moving up the Hype Cycle <a href="https://t.co/iyiEOtIf3H">https://t.co/iyiEOtIf3H</a> <a href="https://t.co/Urs4OMIpFQ">https://t.co/Urs4OMIpFQ</a> <a href="https://t.co/Qnm5WtLZSp">pic.twitter.com/Qnm5WtLZSp</a></p>&mdash; Mark O&#39;Neill (@TheMarkONeill) <a href="https://twitter.com/TheMarkONeill/status/1433413202315038721?ref_src=twsrc%5Etfw">September 2, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">🚨Our next Open Community Working Meeting is UK/EU time zone friendly. <br><br>🗓️2021-09-17 <br>🕑14:00 UTC.<a href="https://t.co/3PS7JGTc5L">https://t.co/3PS7JGTc5L</a> <br><br>🤔Got something you want us to discuss? Add a comment to the issue.<br><br>☕️Looking for something more like having a coffee?<br>keep reading... 👇</p>&mdash; JSON Schema (@jsonschema) <a href="https://twitter.com/jsonschema/status/1435212297119600642?ref_src=twsrc%5Etfw">September 7, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

<blockquote class="twitter-tweet"><p lang="en" dir="ltr">Imitation is the sincerest form of flattery. Loved the concept of JSON rules engine so much, I built a super tiny, highly configurable JSON Schema rules engine: <a href="https://t.co/kliihYAGx5">https://t.co/kliihYAGx5</a>. Reach out if your typescript savvy, help wanted! <a href="https://twitter.com/hashtag/json?src=hash&amp;ref_src=twsrc%5Etfw">#json</a> <a href="https://twitter.com/hashtag/jsonschema?src=hash&amp;ref_src=twsrc%5Etfw">#jsonschema</a></p>&mdash; Adam Jenkins (@akmjenkins) <a href="https://twitter.com/akmjenkins/status/1434877420495118339?ref_src=twsrc%5Etfw">September 6, 2021</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>


<h3>Conclusion</h3>
<p>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. 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>