Don't go OpenAPI first, go API first

• spec

  42 3,843 7.9 JavaScript

  The AsyncAPI specification allows you to create machine-readable definitions of your asynchronous APIs. (by asyncapi)

  

Technical articles and presentations on API-first mainly focus on the technical implementation and use of certain tools, such as back-end code generation from OpenAPI specification, as well as rising interest to AsyncAPI specification that brings standard to event-driven architectures.

• springdoc-openapi

  18 3,086 8.9 Java

  Library for OpenAPI 3 with spring-boot

  

For APIs that should be exposed publicly we use a solution based on springdoc-openapi that generates OpenAPI specification from Java/Kotlin classes. Non JVM services can expose OpenAPI specification by themselves on a dedicated endpoint. Thus, regardless of how the specification is created, it is a public contract.

• WorkOS

  workos.com sponsored

  The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

  

• openapi-generator

  234 19,807 9.9 Java

  OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)

  

From that specification we generated public documentation and client libraries using OpenAPI Generator based pipeline. Library generation also helps maintain the quality and stability of specifications.

Suggest a related project