Changelog: Integrate with Your Favorite Docs Provider!

New features to the Speakeasy Platform - April 16, 2024

As we roll into summer, the days are getting longer but your APIs’ time to 200 will be getting shorter thanks to our new integration with API documentation providers! More on this exciting new feature below, as well as the regular deluge of updates to our code generator!

Let’s get into it 👇

SDK Docs Integration

Production integration involves a lot more than just making an HTTP request. So why does your API reference have a generic fetch call? Authentication, error handling, pagination parsing, request retries, all need to be considered.

Thankfully, SDKs abstract a lot of these concerns for users, making it possible to provide a code snippet that is both concise and useful to your users. And with our new docs integration, it’s now possible to automatically update your SDK code snippets with every new version of your SDKs!

Building a production-ready integration is as easy as ⌘C, ⌘V.

Head to our docs to start integrating SDKs into your docs!

🚢 Improvements and Bug Fixes 🐛

NOTE

Based on the most recent CLI version: Speakeasy v1.253.3 (opens in a new tab)

The Platform

🚢 Speed up validation runs by skipping name resolution
🚢 Global parameters can now be hidden from method signatures by configuring maxMethodParams with extensions
🚢 Support for flattened globals
🚢 deprecated OpenAPI keyword now respected for globals

Terraform

🚢 Always instantiate arrays to empty slices to avoid null being sent over the wire
🚢 Capability to generate resource state upgraders
🚢 Custom set validators, bump terraform-plugin-framework to 1.7.0 with custom dependencies
🚢 Set types in Terraform, x-speakeasy-xor-with / x-speakeasy-required-with validators
🐛 Fix: extensions being ignored when under an allOf
🐛 Fix Terraform support in quickstart command
🐛 Fix: only hoist union subtypes that are primitive to avoid a provider error

C#

🚢 Support multi-level package naming and non-camel case namespaces

Python

🚢 Bump pylint version to 3.1.0 in Python
🚢 Better additionalDeps validation in your gen.yaml file