VOOZH about

URL: https://thenewstack.io/zen-and-the-art-and-science-of-api-development/

⇱ Zen and the Art (and Science) of API Development - The New Stack


TNS
SUBSCRIBE
Join our community of software engineering leaders and aspirational developers. Always stay in-the-know by getting the most important news and exclusive content delivered fresh to your inbox to learn more about at-scale software development.
REQUIRED
It seems that you've previously unsubscribed from our newsletter in the past. Click the button below to open the re-subscribe form in a new tab. When you're done, simply close that tab and continue with this form to complete your subscription.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.
Welcome and thank you for joining The New Stack community!
Please answer a few simple questions to help us deliver the news and resources you are interested in.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Great to meet you!
Tell us a bit about your job so we can cover the topics you find most relevant.
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
Welcome!

We’re so glad you’re here. You can expect all the best TNS content to arrive Monday through Friday to keep you on top of the news and at the top of your game.

What’s next?

Check your inbox for a confirmation email where you can adjust your preferences and even join additional groups.

Follow TNS on your favorite social media networks.

Become a TNS follower on LinkedIn.

Check out the latest featured and trending stories while you wait for your first TNS newsletter.

PREV
1 of 2
NEXT
VOXPOP
As a JavaScript developer, what non-React tools do you use most often?
Angular
0%
Astro
0%
Svelte
0%
Vue.js
0%
Other
0%
I only use React
0%
I don't use JavaScript
0%
Thanks for your opinion! Subscribe below to get the final results, published exclusively in our TNS Update newsletter:
NEW! Try Stackie AI
From clobbered drafts to real-time sync
Apr 14th 2026 10:00am, by David Moore
TypeScript 6.0 RC arrives as a bridge to a faster future
Mar 14th 2026 9:00am, by Darryl K. Taft
Mastra empowers web devs to build AI agents in TypeScript
Jan 28th 2026 11:00am, by Loraine Lawson
2024-10-03 07:00:03
Zen and the Art (and Science) of API Development
sponsor-ambassador,sponsored-post-contributed,
API Management / Developer tools

Zen and the Art (and Science) of API Development

To bring API development into balance, we must stop insulting developers’ intelligence.
Oct 3rd, 2024 7:00am by Steve Rodda
👁 Featued image for: Zen and the Art (and Science) of API Development
Featured image by Rowen Smith for Unsplash+.
Ambassador sponsored this post. Insight Partners is an investor in Ambassador and TNS.

Building, testing and deploying your own code can be painful, especially when you’re under tight deadlines and a limited budget. Collaboration and standardization must be part of that process, and we need to work together so that developers can stay in their inner development loop longer without disrupting their flow.

But time and time again, I see tools that claim to be “dev-first” or to focus on developer experience but that are so convoluted, expensive, complex or abstracted to the point of hand-holding (think “low code” software as a service [SaaS]).

API development is no exception. I’d argue APIs are probably even worse off, as they’ve been an afterthought throughout their rise to becoming the “backbone of modern applications” and given their tendency to proliferate.

According to the apidays API Industry State of the Market report, 41% of companies have more APIs than apps. What’s more, F5 predicts that by 2030, we will have 2 billion APIs with a one-year shelf life. Meanwhile, Salt says 95% of companies have experienced API vulnerabilities in production.

Getting API Development Right

To get API development — or the future of innovation — right, we must have the right tools to do the job. You can’t manage your way into API quality and consistency; you have to develop it.

How do we make development productive and rewarding? Can we revive a model that gives developers the satisfaction of accomplishing their goal and not dreading the journey? Can we help developers avoid wading through endless cryptic docs, or swearing at an interface that repeats the same “easy” action, but not the one they want?

One of the reasons I (and many other developers, I’m sure) got into development as a bright-eyed and bushy-tailed 20-something was that I always reveled in a challenge. (I started coding at age 8; that’s how much I loved it.) I wanted to solve problems, I wanted to “crack the code” and I regularly sought out cool technology and tools that made the experience better. And on the flip side, I didn’t want something so arduous, manual and painful that it sucked the fun out of development either. I needed a balanced middle ground, and I desperately sought harmony.

And after several years focused in the API space with a front-row view of the mess, I realized a vision for an API development tool that struck that balance. I wanted the fun and challenge, but I also wanted the speed and agility to innovate and deploy quickly. This year, my team took on this adventure with me, and we created something that I think meets this challenge.

Introducing Blackbird

Blackbird, which entered general availability on Oct. 2, 2024, is an API development platform that helps developers quickly and thoughtfully produce high-quality APIs. We designed it to support developers without getting in their way, oversimplifying complex tasks or insulting their intelligence.

As apidays said in its report, “New tools like Blackbird from Ambassador have been able to enhance API design practices and speed up some of the more tedious tasks required when working through an API design process and converting outputs into an OpenAPI definition.”

These tools capitalize on AI and temporary production-like environments to decrease cloud spend and increase optimization. They also mean spending less time doing manual, boring work and more time innovating on things that got you excited to be a developer in the first place. If you want to see how it works, create an account and give it a try.

Looking Ahead to 2025

As we look to the year ahead, here are my thoughts on what’s going to impact the future of development.

Developing Greater Consistency

It bears repeating: You can’t manage your way into API quality and consistency; you have to develop it. Developing an API begins with creating a spec — essentially a blueprint of not only what an API needs to do but how it needs to be coded to work as intended. API management looks at ensuring users can access the API as intended, but the core responsibility lives in code writing and standardization.

Consistency doesn’t stop at the standards and documentation process. It also involves a consistent approach to mocking and testing your APIs to ensure quality and security throughout the entire API lifecycle.

The Future of Development Is Temporary

The Buddha taught that everything is temporary and nothing in the universe is essential. Impermanence has always been a trend, but I think in the development world, we are seeing a greater move to serverless architectures and a desire for temporary, prod-like environment spin-ups. Developers no longer want to have to call up their infrastructure team to spin up a new production environment just to test an API or two. Being able to spin up temporary environments means your devs are happy and testing, and your infra team is unbothered. It also decreases the amount of tech debt that all companies, large and small, have to deal with.

Infuse Your Tool Stack With AI (Gently)

AI is the next gold rush, and everyone has been grabbing quickly for their piece of the pie. The market is flooded with “AI-this” and “LLM-that,” but many tools are just fancy ChatGPT wrappers. Many have worried that AI will come for development jobs, but the more important thing is to have balance — “a middle ground where AI can help assist developers improve their API design,” as apidays wrote in its report.

For one example of how this “to AI or not AI” will play out, API spec generation can now be done almost completely using AI tools. You no longer have to write your specs because they’re already out there. Use the time you save on spec generation for the more exciting parts of your development day.

Achieving API Zen

As the new year rapidly approaches, tech leaders need to focus on spending less, producing more (an age-old dichotomy) and trying to make it fun along the way. When cloud spending goes down, and your developers feel empowered rather than exasperated, everyone’s happy. Infusing with the right technology, embracing the temporariness of it all and ensuring consistency in all that you do is the way to get there.

To learn more about my vision, come and talk to me at API World in November, where I’m looking forward to assessing other 2025 API trends.

Ambassador is the cloud native developer experience leader. The company’s developer control plane for Kubernetes integrates the development, deployment, and production infrastructure for developers and organizations worldwide so they can code, ship and run apps faster and easier than ever. Insight Partners is an investor in Ambassador and TNS.
Learn More
The latest from Ambassador
TRENDING STORIES
Steve Rodda, CEO of Ambassador, is focused on driving product-led growth to deliver innovative solutions that simplify Kubernetes and microservices for customers. Steve has decades of a programming and developer background and was previously the CEO of the API design...
Read more from Steve Rodda
Ambassador sponsored this post. Insight Partners is an investor in Ambassador and TNS.
SHARE THIS STORY
TRENDING STORIES
TNS owner Insight Partners is an investor in: Ambassador.
SHARE THIS STORY
TRENDING STORIES
TNS DAILY NEWSLETTER Receive a free roundup of the most recent TNS articles in your inbox each day.
The New Stack does not sell your information or share it with unaffiliated third parties. By continuing, you agree to our Terms of Use and Privacy Policy.
👁 Image
Effective Management of APIs - Managing APIs in Kubernetes Environments: Key Scaling Tips