March 2023 Summaries

Speakeasy has introduced a new flattened structure for its SDKs to enhance the API developer experience by simplifying the process of interacting with APIs. This updated structure abstracts the complexity of distinguishing between query parameters, path parameters, headers, and request bodies, allowing users to provide necessary data as key-value pairs. This change results in less code for users to write, more comprehensible interfaces, faster integration times, and an overall improved developer experience. The transition to this new structure is seamless for users with automated pipelines and requires a simple upgrade for those using the CLI.

In the current software development landscape, the monorepo structure for software development kits (SDKs) has gained traction, particularly popularized by Amazon and now favored by many companies offering multiple APIs. This approach centralizes SDKs in a single repository, facilitating service discovery for users, though it results in larger SDK sizes. Speakeasy supports both monorepo and traditional "repo per API" structures, allowing flexibility in SDK organization while ensuring features like granular management of API updates and the ability to manage API keys without a gateway. Recent improvements include enhanced usage snippets to ensure code examples are accurate and easy to implement, reflecting the evolving needs of developers working within these frameworks.