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