01-28-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: Darrel Miller
  • Description: API Architect, Microsoft Graph
  • Twitter: https://twitter.com/darrel_miller
  • LinkedIn:https://www.linkedin.com/in/darrelmiller/
  • Github:https://github.com/darrelmiller/

• AsyncAPI

  • Name: Nadja Hagen
  • Description: Junior Consultant at Novatec Consulting GmbH
  • Twitter: https://twitter.com/hg_nadja
  • LinkedIn: https://www.linkedin.com/in/hagen-nadja/
  • Github: https://github.com/nadjahagen

• JSON Schema

  • Name: Chuck Reeves
  • Description: DevOps Eningeer featured on Ben's podcast
  • Twitter: https://twitter.com/manchuck
  • LinkedIn:
  • Github: https://github.com/manchuck

• GraphQL

  • Name: Natalia Tepluhina
  • Description: Staff Frontend Engineer at Gitlab
  • Twitter: https://twitter.com/N_Tepluhina
  • LinkedIn: https://www.linkedin.com/in/ntepluhina/
  • Github: https://github.com/NataliaTepluhina

• gRPC

  • Name: Alex Borysov
  • Description: SE at Netflix previously Google, gave us the "g" in gRPC
  • Twitter: https://twitter.com/aiborisov
  • LinkedIn: https://www.linkedin.com/in/aborysov/
  • Github: https://github.com/alxbnet

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: Twilio
  • Description of Use: we have open-sourced an OpenAPI specification in Beta for every Twilio API.
  • URL: https://www.twilio.com/blog/introducing-twilio-open-api-specification-beta

• AsyncAPI

  • Name:
  • Description of Use:
  • URL:

• JSON Schema

  • Name:
  • Description of Use:
  • URL:

• GraphQL

  • Name: Microcks 1.5.0
  • Description of Use: Add GraphQL in new release
  • URL: https://microcks.io/blog/microcks-1.5.0-release/

• gRPC

  • Name: Dapr
  • Description of Use: The proposal is to extract the components into separate go binaries that are individually (or logically grouped) into their own Pods or instances and invoked via gRPC.
  • URL: Enable gRPC based components dapr/dapr#3513

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: Support API mounting
  • Description: It would be great to be able to mount API specs onto another spec for service composition.
  • URL: Support API mounting OAI/OpenAPI-Specification#2854

• AsyncAPI

  • Title: Work on 3.0 release
  • Description: These are the issues that are currently being championed by people, aiming for the 3.0 release.
  • URL: Work on 3.0 release asyncapi/spec#691

• JSON Schema

  • Title: No normative statement in IANA consideration
  • Description: I suggest to avoid normative statements in media type registration.
  • URL: No normative statement in IANA considerations. json-schema-org/json-schema-spec#1176

• GraphQL

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

• gRPC

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

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

• OpenAPI

  • Title: Special Interest Groups (SIGs)
  • Description: Security, Workflows, Overlays, Codegen, Lifecycle, Travel.
  • URL: Special Interest Groups (SIGs) OAI/OpenAPI-Specification#2695

• AsyncAPI

  • Title: Start collecting AsyncAPI use cases
  • Description: Mission statement 😄 "AsyncAPI Community needs a set of real stories from end-users on how they use AsyncAPI in real life".
  • URL: Start collecting AsyncAPI use cases asyncapi/community#187

• JSON Schema

  • Title: Path to standardisation!
  • Description: There have been some really great discussions, and I want to link to as many as possible from here.
  • URL: Path to standardisation! json-schema-org/community#3

• GraphQL

  • Title: None in 2022
  • Description:
  • URL:

• gRPC

  • Title: A collection of grpc protos for learning & reference
  • Description:
  • @reddit: https://www.reddit.com/r/grpc/comments/s9drba/a_collection_of_grpc_protos_for_learning_reference/?utm_source=share&utm_medium=web2x&context=3

Any interesting news?

• OpenAPI

  • Title: Improve API Governance with These Shareable OpenAPI Templates
  • Description:
  • URL: https://blog.postman.com/improve-api-governance-with-shareable-openapi-templates/

• AsyncAPI

  • Title: AsyncAPI Updates
  • Description: News from the project over 2 week period
  • URL: https://gist.github.com/smoya/6bdab3c96485076522fb433aa5555ce6

• JSON Schema

  • Title: Beginning Community Podcast on YouTube
  • Description:
  • URL:

• GraphQL

  • Title: The quest for the universal protocol: REST, XML, and GraphQL
  • Description: In this post we pick up in the early 90s with HTTP and then XML. These technologies helped lay the foundation for the widespread adoption of GraphQL we are seeing today. We will also talk about why Fauna is investing heavily in it.
  • URL: https://fauna.com/blog/the-quest-for-the-universal-protocol-rest-xml-and-graphql

• gRPC

  • Title: Running gRPC and Protobuf on ARM64 (on Linux)
  • Description: Note: currently linux only and does not include Apple M1.
  • URL: https://grpc.io/blog/grpc-on-arm64/

Any interesting tweets?

• OpenAPI

  • Title: APIdeck Reva
  • Description: Validate requests with OpenAPI in Node.js
  • URL: https://twitter.com/gertjanwilde/status/1486735104764375041

• AsyncAPI

  • Title: AsyncAPI and Apicurio for Asynchronous APIs
  • Description:
  • URL: https://twitter.com/apievangelist/status/1486350928349253637

• JSON Schema

  • Title: Announcing our first video series
  • Description:
  • URL: https://twitter.com/jsonschema/status/1486702609335570444

• GraphQL

  • Title: GraphQL Berlin Meetup
  • Description: Federating the Content Layer with GraphCMS", Nexus Prisma, and GraphQL caching.
  • URL: https://twitter.com/NWoroniec/status/1485610312330063876

• gRPC

  • Title: Ballerina services expose gRPC
  • Description: Remote methods in Ballerian services are there to support gRPC
  • URL: https://twitter.com/sameerajayasoma/status/1484643825347809280

Any interesting videos?

• OpenAPI

  • Title: Ballerina OpenAPI Support
  • Description: - Documenting Ballerina Services with OpenAPI, OpenAPI Validator, Generating Connectors with OpenAPI
  • URL: https://www.youtube.com/watch?v=cJwstQ8yynk

• AsyncAPI

  • Title:
  • Description:
  • URL:

• JSON Schema

  • Title: So you think you understand JSON Schema?
  • Description: Ben Hutton talk at ASP 2021
  • URL: https://www.youtube.com/watch?v=vMG0NCDifI0

• GraphQL

  • Title: GraphQL Introspection
  • Description: Learn about the built-in GraphQL introspection system, and how you can find out more about the schema using GraphQL queries.
  • URL: https://graphql.wtf/episodes/25-graphql-introspection

• gRPC

  • Title: Dapr Community Call
  • Description: Pluggable gRPC components for Dapr. Dapr is a portable, serverless, event-driven runtime that makes it easy for developers to build resilient, stateless and stateful microservices that run on the cloud and edge and embraces the diversity of languages and developer frameworks.
  • URL: https://www.youtube.com/watch?v=Uijl_t8uQNQ

Any interesting tools?

• OpenAPI

  • Title: APIdeck Reva
  • Description: Validate requests with OpenAPI in Node.js
  • URL: https://twitter.com/apideck

• AsyncAPI

  • Title: Asynchronous enterprise architecture design using AsyncAPI
  • Description: AsyncAPI offers a promising means to accelerating organizational standards around asynchronous message formats. Here is what that looks like.
  • URL: https://www.redhat.com/architect/asynchronous-architecture-asyncapi

• JSON Schema

  • Title: Better JSON Schema Analysis with json-schema-report

  • Description: A tool called json-schema-report that makes it much easier to debug such large schemas and save a lot of time.

  • URL: https://blog.chrislewis.me.uk/?post=2021-08-25-Better-JSON-Schema-Analysis-with-json-schema-report

• GraphQL

  • Title: Microcks - new release version
  • Description: Version 1.5.0 of Microcks add GraphQL support to the OSS Kubernetes-native toolset for API Mocking and Testing.
  • URL: https://microcks.io/blog/microcks-1.5.0-release/

• gRPC

  • Title: Introducing WebSockets, HTTP/2 and gRPC bidirectional streams for Cloud Run
  • Description:
  • URL: https://cloud.google.com/blog/products/serverless/cloud-run-gets-websockets-http-2-and-grpc-bidirectional-streams

Scope

Quantifying the scope of the communities week by week.

Twitter Followers

Measuring the activity that occurs across Twitter

• OpenAPI: 7,688
• AsyncAPI: 2,994
• JSON Schema: 827
• GraphQL: 70,875
• gRPC: 15,775

Github Scope

Measuring the activity occurring across Github

• OpenAPI

  • Github Repo Forks: 8,032
  • Github Repo Watch: 860
  • Github Repo Stars: 22,872

• AsyncAPI

  • Github Repo Forks: 165
  • Github Repo Watch: 50
  • Github Repo Stars: 1,912

• JSON Schema

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

• GraphQL

  • Github Repo Forks: 1,104
  • Github Repo Watch: 542
  • Github Repo Stars: 13,606

• gRPC

  • Github Repo Forks: 8,715
  • Github Repo Watch: 1,353
  • Github Repo Stars: 33,207

Stack Overflow Questions

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

• OpenAPI : 9,400
• AsyncAPI: 126
• JSON Schema: 32,316
• GraphQL: 44,099
• gRPC: 16,127