Language Maturity Concepts
Speakeasy creates and maintains SDKs (generation targets) for your API. This page explains the terminology used to describe these generation targets.
Maturity Levels
| Maturity Level | Description |
|---|---|
| Alpha | An early preview of upcoming features intended for gathering feedback. Alpha versions are less complete and likely to be unstable, with frequent updates and significant changes expected. |
| Beta | A pre-release version that includes many features of GA but is still subject to significant modifications based on user feedback. The interface is considered stable enough for general usage and wide coverage of OpenAPI is available. |
| General Availability (GA) | A fully supported release that includes all functionalities altering the type interface from OpenAPI Specification keywords (for example, oneOf, anyOf, allOf, const, and default). GA versions follow semantic versioning (SemVer) and maintain interface stability for non-breaking OpenAPI changes unless you opt into such changes. |
Feature Support Levels
Feature support levels indicate the extent of additional functionalities provided.
| Feature Support Level | Description |
|---|---|
| Gold | Indicates full feature support, including all opt-in enhancements such as Pagination, Retries, Server Templates, Hooks, OAuth 2.0 Client Credentials, and more. A target can be in Beta and still have Gold-level feature support. |
| Level 2 | Extends the type interface by synthesizing multiple API calls into single interactions. This is achieved using specified links (opens in a new tab) (hyperlinks between API operations as defined by the OpenAPI Specification), Arazzo workflows (opens in a new tab) (predefined sequences of API calls), and Speakeasy extensions (custom enhancements for better API integration). |
| Level 1 | Provides essential functionalities and basic support without the advanced features found in Gold or Level 2. Targets with Standard support are stable and reliable but do not include all opt-in enhancements or extended interface capabilities. |
Target Language Support
| Target | Maturity Level | Feature Support Level |
|---|---|---|
| TypeScript | GA | Gold |
| Go | GA | Gold |
| Java | GA | Gold |
| Python - Pydantic & Async | GA | Gold |
| C# | GA | Gold |
| Terraform | GA | Level 2 |
| Unity | Beta | Level 1 |
| PHP | Beta | Level 1 |
| Swift | Alpha | Level 1 |
| Ruby | Alpha | Level 1 |
| Postman | Alpha | Level 1 |
Deprecated Generation Targets
- TypeScript Beta (v1)
- Java Beta (v1)