02-11-2022 Weekly Landscape Report

[doc-jones]

This is the weekly report across five of the leading API specifications, providing a snapshot of these communities that can be used to develop awareness, quantify the scope of, and increase engagement within these communities.

People

Identify one person each week who is doing interesting things within each of these formats.

• OpenAPI

  • Name: Sekhar Banerjee
  • Description: Principle Architect, eBay and self proclaimed OpenAPI evangelist
  • Twitter:
  • eBay: https://tech.ebayinc.com/authors/shekhar-banerjee/#biography

• AsyncAPI

  • Name: Bilgin Ibryam
  • Description: Product Manager, Cloud at Red Hat
  • Twitter: https://twitter.com/bibryam
  • LinkedIn: https://www.linkedin.com/in/bibryam/
  • Github: https://github.com/bibryam

• JSON Schema

  • Name: Anthony Shaw
  • Description: OSS, Microsoft
  • Twitter: https://twitter.com/anthonypjshaw
  • LinkedIn: https://www.linkedin.com/in/anthonypshaw/?originalSubdomain=au
  • Github: https://github.com/tonybaloney

• GraphQL

  • Name: Sasha Solomon
  • Description: Staff SWE & Tech Lead of Core API Platform Team @ Twitter and current member of the GraphQL WG.
  • Twitter: https://twitter.com/sachee
  • LinkedIn: https://www.linkedin.com/in/sasha-s-3808365a/
  • Github: https://github.com/sachee

• gRPC

  • Name: Yuxuan Li
  • Description: Google Senior SWE
  • Twitter:
  • LinkedIn: https://www.linkedin.com/in/yuxuan-li-66078b41/
  • Github: https://github.com/yuxuanli

Adoption

Identify one company or organization that has adopted one of each of these formats (head start available here: OpenAPI, AsyncAPI, JSON Schema)

• OpenAPI

  • Name: Treblle
  • Description of Use: API Monitoring and Analytics
  • URL: https://www.openapis.org/blog/2022/02/10/treblle-api-monitoring-and-analytics-is-openapis-newest-member?utm_content=197544750&utm_medium=social&utm_source=twitter&hss_channel=tw-4855039169

• AsyncAPI

  • Name: Red Hat
  • Description of Use: The service registry component is based on Apicurio. You can use it to store and retrieve service artifacts such as OpenAPI specifications and AsyncAPI definitions, and for schemas such as Apache Avro, JSON, and Google Protobuf. We've provided Red Hat Integration's Service Registry 1.1 component as a general availability (GA) release in Red Hat Integration 2020-Q4.
  • URL: https://developers.redhat.com/blog/2020/12/09/new-features-and-storage-options-in-red-hat-integration-service-registry-1-1-ga

• JSON Schema

  • Name: Axway
  • Description of Use: Amplify
  • URL: https://blog.axway.com/api-streaming/asyncapi

• GraphQL

  • Name: Open Collective
  • Description of Use: Today, Open Collective is mostly a "website" and we would like to evolve in the direction of becoming more a "platform", an infrastructure. For this, one key aspect is the API and developers tools.
  • URL: [Strategic Focus] API, Open Collective as a platform opencollective/opencollective#5140

• gRPC

  • Name: N/A
  • Description of Use:
  • URL:

The Beat

Make sure we are covering the beat each week and surfacing relevant information from across the communities.

Any interesting issues? (OpenAPI, AsyncAPI, JSON Schema. GraphQL, gRPC)

• OpenAPI

  • Title: Define the need for documentation beyond the current scope of the OAS
  • Description: The OAS currently focuses on discrete API operations with no implications of what happens before or after this instance of an API call. There are scenarios where there are specific or implied relationships between a group of APIs that can not be expressed in a machine readable format in the OAS and hence can only be communicated out of band by some other means. The draft proposal is to create a machine readable format that would be useful to tool providers, now or in the future, that provides actionable instructions of the intended relationships within a group of APIs.
  • URL: Define the need for documentation beyond the current scope of the OAS OAI/OpenAPI-Specification#2872

• AsyncAPI

  • Title: Make Server Variables Object available as reusable objects under the Component object.
  • Description:
  • URL: Make Server Variables Object available as reusable objects under the Component object asyncapi/spec#707

• JSON Schema

  • Title: N/A
  • Description:
  • URL:

• GraphQL

  • Title: Work on validation/execution of Fragment Arguments RFC
  • Description:
  • URL: [2021-06-03] Work on validation/execution of Fragment Arguments RFC graphql/graphql-wg#791

• gRPC

  • Title: AuthContext properties are not reset on subsequent calls
  • Description: It seems the behavior is expected. The auth_context is per-channel, and AuthMetadataProcessor::Process calls per-rpc. For a particular channel, we can have multiple rpc requests. When you update the information in one rpc, it's likely you will see the change in another rpc process request.
  • URL: AuthContext properties are not reset on subsequent calls grpc/grpc#28809

Any interesting discussions? (OpenAPI, AsyncAPI, JSON Schema, GraphQL, gRPC)

• OpenAPI

  • Title: What is the meaning of a Media Type Object with no schema defined?
  • Description: At the moment, we only support JSON Schema for the Schema Object, meaning you can only describe JSON payloads (and to some limited extent XMLs). Had we supported things like XSD (which we may in the future), that would allow you to define schemas (or something similar) for additional media types.
  • URL: What is the meaning of a Media Type Object with no schema defined? OAI/OpenAPI-Specification#2874

• AsyncAPI

  • Title: Proposal for community building/scaling goals for 2022
  • Description: There are 3 big topics for 2022 that should be priority 1, followed by many other suggestions.
  • URL: Proposal for community building/scaling goals for 2022 asyncapi/community#193

• JSON Schema

  • Title: Forward compatibility with must-understand keywords
  • Description: When submitting JSON Schema as an Internet media type (e.g. application/schema+json), one of the potential problems in JSON Schema is: how does it support forward compatibility?
  • URL: Forward compatibility with must-understand keywords json-schema-org/community#119

• GraphQL

  • Title: Enforcing delivery order of payloads - Defer-Stream WG
  • Description: It was discussed in the 2021-07-01 WG meeting and 2021-12-02 WG meeting and the group agreed that responses like this must be ordered to ensure payload paths do not reference fields that have not been sent yet.
  • URL: Enforcing delivery order of payloads graphql/defer-stream-wg#17

• gRPC

  • Title: Implementing a logging application using gRPC
  • Description: googlegroups discussion
  • URL: https://groups.google.com/g/grpc-io/c/okH4I4oSERY

Any interesting news?

• OpenAPI

  • Title: Twilio Live
  • Description: See Demo from Twilio using Postman and OpenAPI to create a live stream
  • URL: https://www.twitch.tv/videos/1293529141

• AsyncAPI

  • Title: Planning for 2022
  • Description: Proposal for community building/scaling goals for 2022
  • URL: Proposal for community building/scaling goals for 2022 asyncapi/community#193

• JSON Schema

  • Title:
  • Description:
  • URL:

• GraphQL

  • Title: What Is Apollo Federation?
  • Description: It’s not a product that we offer but instead, it’s a specification or a standard for building a distributed graph.
  • URL: https://www.apollographql.com/blog/backend/federation/what-is-apollo-federation/

• gRPC

  • Title: first gRPC Community Meetup of 2022
  • Description: In this talk, Ali Hassan, Entrepreneur and engineer in computer science & economics. Founder of WisdomEnigma Inc will present: “gRPC Connection”
  • URL: https://groups.google.com/g/grpc-io

Any interesting tweets?

• OpenAPI

  • Title: OpenAPI's newest member announced
  • Description: Trebelle joins OpenAPI
  • URL: https://twitter.com/OpenApiSpec/status/1491886136754688004

• AsyncAPI

  • Title: AsyncAPISpec: Spec and parsers.
  • Description: Bi-weekly report
  • URL: https://twitter.com/smoyac/status/1491884836671442948

• JSON Schema

  • Title: The value proposition of JSON Schema
  • Description: From XML to JSON Schema
  • URL: https://twitter.com/dret/status/1491852831296561167

• GraphQL

  • Title: Netflix Engingeering: GraphQL tools
  • Description: Asks about favorite GraphQL and 197 tweet replies
  • URL: https://twitter.com/NetflixEng/status/1488937473082200066

• gRPC

  • Title: gRPC testing from Smart Bear
  • Description: Link to blog post
  • URL: https://twitter.com/SmartBear/status/1491423399037521921

Any interesting videos?

• OpenAPI

  • Title: Twilio Live
  • Description: See Demo from Twilio using Postman and OpenAPI to create a live stream
  • URL: https://www.twitch.tv/videos/1293529141

• AsyncAPI

  • Title: APIs and Stuff
  • Description: Twitter Spaces - recorded audio only
  • URL: https://twitter.com/medjawii/status/1491060814085824517

• JSON Schema

  • Title: JSON Schema in 60 seconds
  • Description: Validation example, schema reuse and who uses JSON Schema
  • URL: https://www.youtube.com/watch?v=JpzH8Eq663o

• GraphQL

  • Title: February Monthly GraphQL WG Meeting
  • Description: The GraphQL Working Group meets monthly to discuss proposed additions to the GraphQL Specification and other relevant topics to core GraphQL projects.
  • URL: https://www.youtube.com/watch?v=bMkSaICB4mI&t=1148s

• gRPC

  • Title: Deep Dive: gRPC
  • Description: This presentation will dive into the architecture of gRPC-Go, mainly the surface (gRPC) layer, transport layer, resolver component and balancer component. It will also include a brief introduction to key gRPC features such as binary logging, channelz (runtime debugging), service config and rpc retry along the way.
  • URL: https://www.youtube.com/watch?v=vom_vLKfVkc

Any interesting tools?

• OpenAPI

  • Title: spec-linter
  • Description: API that wraps the Spectral project for linting OpenAPI, AsyncAPI, and really any JSON document.
  • URL: https://twitter.com/kevinswiber/status/1489400190754693123

• AsyncAPI

  • Title: spec-linter
  • Description: API that wraps the Spectral project for linting OpenAPI, AsyncAPI, and really any JSON document.
  • URL: https://twitter.com/kevinswiber/status/1489400190754693123

• JSON Schema

  • Title:
  • Description:
  • URL:

• GraphQL

  • Title: apollo-parser and apollo-encoder
  • Description: New releases of apollo tools written in Rust
  • URL: https://twitter.com/BnJ25/status/1492137294869975043

• gRPC

  • Title: NGINX App Protect DoS
  • Description: protect gRPC from attack
  • URL: https://twitter.com/nginx/status/1491940815211487237

Any interesting events?

• OpenAPI

  • Title: API & MICROSERVICES
  • Description: Developer Week Conference
  • URL: https://www.developerweek.com/conference/api-microservices-conference/

• AsyncAPI

  • Title: Uptime, Aiven conference CFP March 9, 2022
  • Description: The conference on open source data in the cloud on September 14-15 in Amsterdam!
  • URL: https://sessionize.com/uptime-conference-2022/

• JSON Schema

  • Title: N/A
  • Description:
  • URL:

• GraphQL

  • Title: GraphQL Summit 2021
  • Description: Apollo GraphQL conference
  • URL: https://summit.graphql.com

• gRPC

  • Title: solo.io webinar
  • Description: Join us for this hands-on workshop as we explore how to catalog, document, expose, securely publish gRPC and REST APIs using Gloo Portal and either Gloo Edge
  • URL: https://twitter.com/soloio_inc/status/1489524176440471556

Scope

Quantifying the scope of the communities week by week.

• ↑ increase from last week
• ↓ decrease from last week
• nc no change from last week

Twitter Followers

Measuring the activity that occurs across Twitter

• OpenAPI: 7,730 ↑
• AsyncAPI: 3,043 ↑
• JSON Schema: 877 ↑
• GraphQL: 71,660 ↑
• gRPC: 15,864 ↑

Github Scope

Measuring the activity occurring across Github

• OpenAPI

  • Github Repo Watch: 862
  • Github Repo Forks: 8,070
  • Github Repo Stars: 22,989

• AsyncAPI

  • Github Repo Watch: 49
  • Github Repo Forks: 171
  • Github Repo Stars: 1,939

• JSON Schema

  • Github Repo Watch: 102
  • Github Repo Forks: 235
  • Github Repo Stars: 2,494

• GraphQL

  • Github Repo Watch: 542
  • Github Repo Forks: 1,107
  • Github Repo Stars: 13,624

• gRPC

  • Github Repo Watch: 1,355
  • Github Repo Forks: 8,759
  • Github Repo Stars: 33,307

Stack Overflow Questions

Measuring the activity on Stack Overflow using number of overall questions.

• OpenAPI : 9,544 ↑
• AsyncAPI: 126
• JSON Schema: 32,503 ↑
• GraphQL: 44,482 ↑
• gRPC: 16,272 ↑