01-14-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: Isabelle Mauny
  • Description: Field CTO & co-founder 42Crunch
  • Twitter: https://twitter.com/isamauny
  • LinkedIn: https://www.linkedin.com/in/isamauny/
  • Github: https://github.com/isamauny

• AsyncAPI

  • Name: Dale Lane
  • Description: Architect, Kafka, IBM Cloud
  • Twitter: https://twitter.com/dalelane
  • LinkedIn: https://www.linkedin.com/in/dalelane/
  • Github: https://github.com/dalelane

• JSON Schema

  • Name: Kenshi Shiode
  • Description: Software Engineer, Cookpad
  • Twitter: N/A
  • LinkedIn: https://www.linkedin.com/in/kenshi-shiode-b65922212/
  • Github: https://github.com/solt9029

• GraphQL

  • Name: Irina Shestak
  • Description: Apollo Developer Tools Lead
  • Twitter https://twitter.com/_lrlna
  • LinkedIn: https://www.linkedin.com/in/lrlna/
  • Github: https://github.com/lrlna

• gRPC

  • Name: Matthias Grüter
  • Description: Engineering Manager, Spotify
  • Twitter: https://twitter.com/mattgruter
  • LinkedIn: https://www.linkedin.com/in/grueter/
  • Github: https://github.com/mattgruter

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: VMware Tanzu
  • Description of Use: API Discovery Is Now at Your Fingertips: API Portal
  • URL: https://tanzu.vmware.com/content/blog/api-discovery-api-portal-for-vmware-tanzu-is-ga

• AsyncAPI

  • Name: Microcks
  • Description of Use: Microcks is now able to import AsyncAPI definitions for enriching the API catalogs with Event typed APIs.
  • URL: https://microcks.io/documentation/using/asyncapi/

• JSON Schema

  • Name: Linux Kernel
  • Description of Use: Writing Devicetree Bindings in json-schema
  • URL: https://www.kernel.org/doc/html/latest/devicetree/bindings/writing-schema.html

• GraphQL

  • Name: The Graph Foundation Awards $48M Grant to The Guild to Join The Graph as a Core Developer
  • Description of Use: The Guild team joining forces with other core developers in The Graph to build the best API solutions for dapp developers. The team’s experience is unparalleled and this commitment signifies a major shift in developer attention from web2 to web3.
  • URL: https://thegraph.com/blog/guild-announcement
  • Footnote: The Guild will port common GraphQL JS libraries to Rust: porting certain APIs to Rust to unlock integrations with Graph Node and other web3 protocols to allow for features like scheme stitching and transformations

• gRPC

  • Name: Kubernetes 1.23 Released with Improved Events, gRPC Probes, and Support for Dual-Stack
  • Description of Use: gRPC probes have been introduced to enable developers to improve the resiliency of applications by adding liveness or readiness probes, not only for the HTTP or TCP protocols, but for gRPC
  • URL: https://www.infoq.com/news/2021/12/kubernetes-1-23/

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: Reusable media types
  • Description: This would enable servers to control their own namespace through media types and link relations (via Link header, etc.)
  • URL: Reusable media types OAI/OpenAPI-Specification#2845

• AsyncAPI

  • Title: Let channels be identified by an ID rather than their address.
  • Description:
  • URL: Let channels be identified by an ID rather than their address. asyncapi/spec#663

• JSON Schema

  • Title: Reorganizing the meta-schemas
  • Description:
  • URL: Reorganizing the meta-schemas json-schema-org/json-schema-spec#1159

• GraphQL

  • Title: Why are edges and their properties second class citizens?
  • Description: It's really hard to work with edges, their directions and their properties in Graphql. We are basically forced to create nodes that interconnect nodes.
  • URL: Why are edges and their properties second class citizens? graphql/graphql-spec#910

• gRPC

  • Title: Latency increase starting 1.31.0
  • Description: More than 2X increase in latency time on the client after upgrade
  • URL: Latency increase starting 1.31.0 grpc/grpc#28533

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

• OpenAPI

  • Title: Special Interest Groups (SIGs)
  • Description: Following the launch of OpenAPI version 3.1.0, there were so many interesting topics for the community to explore that we created specific Special Interest Groups (SIGs)
  • URL: Special Interest Groups (SIGs) OAI/OpenAPI-Specification#2695

• AsyncAPI

  • Title: Start collecting AsyncAPI use cases
  • Description:
  • URL: Start collecting AsyncAPI use cases asyncapi/community#187

• JSON Schema

  • Title: Restructuring Output Formats
  • Description:
  • URL: Restructuring Output Formats json-schema-org/community#63

• GraphQL

  • Title: Alternative 2.0 Architectural Proposal
  • Description: The main difference with this variant proposal is two editors instead of one, and though this may seem more impractical, I will attempt to prove why it may be even more practical.
  • URL: Dual Editors - an Alternative 2.0 Architectural Proposal graphql/graphiql#1787

• gRPC

  • Title: 2022-01-11 gRPC benchmark results
  • Description: We introduced a major change for the protobuf payload
  • URL: https://www.reddit.com/r/grpc/comments/s22jh2/20220111_grpc_benchmark_results/

Any interesting news?

• OpenAPI

  • Title: APIsecurity.io Newsletter
  • Description: OpenAPI definitions from HTTP traffic
  • URL: https://apisecurity.io/issue-166-securing-large-api-ecosystems-creating-openapi-http-traffic-frankenstein-apis-api-proliferation/

• AsyncAPI

  • Title: How to Use the AsyncAPI Standard for Real-Time APIs
  • Description: Eric Newcomer CTO of WSO2 thorough discussion.
  • URL: https://www.rtinsights.com/how-to-use-the-asyncapi-standard-for-real-time-apis/

• JSON Schema

  • Title: Data Mesh Architecture and the Role of APIs & JSON Schemas
  • Description: Data Mesh and APIs are much more closely related than you may realize. In fact, APIs and their close cousin JSON Schemas are foundation components of the Data Mesh.
  • URL: https://towardsdatascience.com/tagged/json-schema

• GraphQL

  • Title: The State of GraphQL
  • Description: Hear from core contributors & more about upcoming releases, recent milestones, and community initiatives! Coming Feb 1st.
  • URL: https://www.graphql-meetup.com/#/

• gRPC

  • Title: Postman Now Supports gRPC
  • Description: First-class support for gRPC in Postman is currently in beta. You can now test your gRPC APIs with Postman v9.7.1 and above.
  • URL: https://blog.postman.com/postman-now-supports-grpc/

Any interesting tweets?

• OpenAPI

  • Title: Deploy OpenAPI enabled Azure Functions with .NET in Visual Studio
  • Description: @justinchronicle demos his extension and shows us how easy it is to get HTTP-triggered #dotNET functions with OpenAPI support and deploy an Azure Functions app with Azure API Management from #VisualStudio.
  • URL: https://mobile.twitter.com/dotnet/status/1471999409919561735

• AsyncAPI

  • Title: Article
  • Description: Points article demo of combinig AsyncAPI Microcks and Kafka.
  • URL: https://twitter.com/lucasjellema/status/1480940408402325504?s=19

• JSON Schema

  • Title: EventCatalog
  • Description: Amazing tool for documenting events and event flows, with support for JSON schema and soon #AsyncAPI specifications.
  • URL: https://twitter.com/timhaselaars/status/1481350512771538950?s=20

• GraphQL

  • Title: FastAPI Microservice Patterns: GraphQL API
  • Description:
  • URL: https://twitter.com/FerroRodolfo/status/1481827593120747522?s=20

• gRPC

  • Title: An Architect's guide to APIs: SOAP, REST, GraphQL, and gRPC
  • Description:
  • URL: https://twitter.com/opensourceway/status/1480991403698180097?s=20

Any interesting videos?

• OpenAPI

  • Title: How to build an OpenAPI Specification using YAML?
  • Description: This video is part of “The Ultimate YAML Course: Learn YAML from Scratch"
  • URL: https://www.youtube.com/watch?v=87ZFvJ7_-n0

• AsyncAPI

  • Title: Going AsyncAPI: The Good, The Bad, and The Awesome
  • Description: In this talk, I’ll explore the good, bad, and awesome aspects of building Async API into our open data hub.
  • URL: https://www.youtube.com/watch?v=bSfgNDJf97M

• JSON Schema

  • Title: Maintaining JSON Schemas at Scale
  • Description: In this talk, we will cover the keywords, concepts, and patterns for maintaining large schemas or large collections of schemas.
  • URL: https://www.youtube.com/watch?v=GjJpRsVffg0

• GraphQL

  • Title: The GraphQL Documentary
  • Description: The story of GraphQL: it's creation and early impact.
  • URL: https://www.youtube.com/watch?v=783ccP__No8

• gRPC

  • Title: gRPC November Meetup
  • Description: gRPC integration and its applications in Hive Metastore
  • URL: https://www.youtube.com/watch?v=_2afVH8Of6E

Any interesting tools?

• OpenAPI

  • Title: Red Hat OpenAPI Generator
  • Description: Tutorial
  • URL: https://appdev.consulting.redhat.com/tracks/contract-first/openapi-generator.html#openapi-generator

• AsyncAPI

  • Title: nestjs-asyncapi
  • Description: The idea is to generate AsyncApi documentation (for event-based services like websockets) similar to nestjs/swagger.
  • URL: https://www.npmjs.com/package/nestjs-asyncapi

• JSON Schema

  • Title: clevercloud-sdk 0.5.3
  • Description: Use schemas to add a derive instruction to generate json schemas representation of structures
  • URL: https://crates.io/crates/clevercloud-sdk

• GraphQL

  • Title: Trace
  • Description: A lightweight, open-source GraphQL query performance monitoring GUI that provides users with real-time, resolver-level performance tracing metrics and error logging.
  • URL: https://medium.com/@patconstant_9253/trace-for-graphql-query-tracing-at-the-resolver-level-59dcdab757e7

• gRPC

  • Title: Apache Arrow Flight
  • Description: Apache Arrow Flight is a gRPC based protocol for exchanging Arrow data between processes.
  • URL: https://crates.io/crates/arrow-flight

Scope

Quantifying the scope of the communities week by week.

Twitter Followers

Measuring the activity that occurs across Twitter

• OpenAPI: 7,652
• AsyncAPI: 2,964
• JSON Schema: 806
• GraphQL: 70,192
• gRPC: 15,660

Github Scope

Measuring the activity occurring across Github

• OpenAPI

  • Github Repo Forks: 8,005
  • Github Repo Watch: 860
  • Github Repo Stars: 22,776

• AsyncAPI

  • Github Repo Forks: 162
  • Github Repo Watch: 51
  • Github Repo Stars: 1,888

• JSON Schema

  • Github Repo Forks: 234
  • Github Repo Watch: 101
  • Github Repo Stars: 2,465

• GraphQL

  • Github Repo Forks: 1,099
  • Github Repo Watch: 542
  • Github Repo Stars: 13,595

• gRPC

  • Github Repo Forks: 8,677
  • Github Repo Watch: 1,353
  • Github Repo Stars: 33,095

Stack Overflow Questions

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

• OpenAPI : 9,265
• AsyncAPI: 126
• JSON Schema: 32,176
• GraphQL: 43,739
• gRPC: 15,991