Background image
Featured blog post image

Changelog: API Linting & Postman Generation

New features to the Speakeasy Platform - May 15, 2024

Two exciting new features are coming to Speakeasy this week: API Linting and Postman Collection Generation.

Let's get into it ๐Ÿ‘‡

API Linting

Where does API developer experience start? SDKs are super important, but they're the final step in the integration process. The first step is the API itself and making sure that a consistent interface is being exposed. How do you ensure that your API is consistent, especially as the number of developers contributing grows? With an API linter of course!

Now, linters don't have the greatest reputation in the developer community, but that bad reputation is deserved. Most linters have been a drag on developer productivity. They throw up opaque warnings and unnecessarily block progress on feature development. We saw an opportunity to do better.

We've focused on making sure the Speakeasy linter will speed up development, rather than slows it down. Here's how our linter is different:

  • It runs where your work happens:
    • Speakeasy CLI
    • VS Code extension
    • CI/CD pipelines
  • The output is human-readable and clearly actionable
  • It comes with our robust default ruleset that can be easily customized with spectral rules to match your org's API style guide.

To get started just update to the latest version of the Speakeasy CLI and run speakeasy lint.

Postman Collection Generation [Alpha]

Ready your curl requests, because Speakeasy is now able to generate high quality Postman Collections from your OpenAPI document.

Postman Collections facilitate the easy adoption, development, and testing of your APIs. They allow users to understand the API's capabilities quickly through executing API requests without the need to set up a coding environment.

As with any API artifact, a collection is only as useful as it is up-to-date. Speakeasy's Postman Collection generation is designed to be a seamless part of your API development workflow.

Collection generation is free while it's in alpha, so give it a try and let us know what you think!

๐Ÿšข Improvements and Bug Fixes ๐Ÿ›

Info Icon

NOTE

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

The Platform

๐Ÿšข Perf: Speed up validation runs by skipping name resolution

Typescript

๐Ÿงน Chore: Remove some unused inbound zod types

Terraform

๐Ÿšข Feat: Support mapping environment variables to provider configuration
๐Ÿšข Feat: Composite Import support
๐Ÿšข Feat: Generate import.sh snippets for additional terraform resource documentation
๐Ÿšข Feat: Support custom (non generated) resources and datasources being added into the provider
๐Ÿ› Fix: always instantiate required arrays to empty slices to avoid null being sent over the wire
๐Ÿ› Fix: extensions being ignored when under an allOf

JavaV2

๐Ÿšข Feat: Better examples

C#

๐ŸŽ‰ Now in GA! ๐ŸŽ‰
๐Ÿšข Feat: Retries
๐Ÿšข Feat: oneOf (union) support
๐Ÿงน Chore: Reduced HttpClient instantiation

Python

๐Ÿ› Fix: after_error hook better error handling

CTA background illustrations

Start to Speakeasy!

Create great integration experiences for your APIs