--- type: "article" title: "Goodbye Apiary.io; Building a great API program - API Developer Weekly" summary: "Goodbye Apiary.io; Building a great API program" newsletter: "API Developer Weekly" newsletter_handle: "api-developer-weekly" newsletter_url: "https://usecommune.com/n/api-developer-weekly" author: "James Higginbotham (@jhigginbotham)" published: "2025-12-18T19:00:00.000Z" canonical_url: "https://usecommune.com/n/api-developer-weekly/a/goodbye-apiary-io-building-a-great-api-program-api-developer-2" markdown_url: "https://usecommune.com/n/api-developer-weekly/a/goodbye-apiary-io-building-a-great-api-program-api-developer-2.md" chat_url: "https://usecommune.com/n/api-developer-weekly/a/goodbye-apiary-io-building-a-great-api-program-api-developer-2/chat" source_url: "http://eepurl.com/juOXP2" body_source: "imported" likes: 0 replies: 0 body_words: 891 --- # Goodbye Apiary.io; Building a great API program - API Developer Weekly ![](https://mcusercontent.com/5005148108dfbac726f74e31e/images/04b6c7bf-305e-b933-367e-a79a24d334d5.png) ![](https://mcusercontent.com/5005148108dfbac726f74e31e/images/9dff09fa-af28-ed1e-7fa6-a6589b89e5e1.png) # API Developer Weekly # Dec 18, 2025 - Issue #566 *This is it - the last newsletter of 2025. ๐ŸŽ‰* *For this last edition of 2025, we have a celebration of Apiary.io, which has officially shut its doors. We also look at how to build a great API program that drives growth, the HTTP QUERY method is becoming official, and a look at how to build idempotency into your API from the start (and why). Finally, we look at the new Interactions API that unifies models and agents, Anthropic donates the MCP specification to the Linux Foundation, analysis of the first year of MCP, how to create a great conference speaker pitch, and AI-driven API economy predictions for 2026. I also want to thank each one of you for continuing to subscribe and share this newsletter. It has been over a decade of delivering this hand-curated newsletter. While I had to slow down the number of issues a bit this year, it continues to be an honor and a pleasure to occupy a bit of your inbox.* *-- Happy Reading, Merry Christmas, and Happy New Year! ๐ŸŽ‰๐ŸŽ‰๐ŸŽ‰ P.S. I just released a report that details how you can use LLMs to assist your API design efforts, speeding up the process by 60% or more. The approach takes an "AI-in-the-loop" perspective that blends your expertise with the LLM's ability to speed up artifact generation and catch gaps in your assumptions. [Check it out here](https://launchany.com/ai-assisted-api-design-report/) to learn more about how to do it, what it looks like, and which LLMs are the best choice.* # Featured Articles [Goodbye Apiary.io, You'll Be Missed](https://apisyouwonthate.com/blog/goodbye-apiary-io/) Today we say farewell to a legend in the API documentation space as O.G. API design-first solution Apiary.io shuts its doors. \[apisyouwonthate.com\] [Building a Great API Program That Drives Growth](https://www.youtube.com/watch?v=vCqUoyq8hd0) A talk given by Derric Gilling from WSO2 at the 2025 Platform Summit in Stockholm, Sweden. This talk discusses best practices for productizing APIs and getting developers to adopt your API. We'll focus on determining the healthy metrics for your developer program, such as Time to First Hello World (TTFHW) and integration rate, and ways to improve them. by Nordic APIs \[youtube.com\] [Idempotency: The API Safety Net](https://medium.com/@akshaybhavukesan/idempotency-the-api-safety-net-75f4828bdfec) Idempotency: The API Safety Net Intro: The "Spinner of Doom" We have all been there. You are purchasing concert tickets or transferring money. You hit "Submit." The spinner spins. And spins ... by Akshay Bhavukesan \[medium.com\] [Announcing the aep-2026 Release](https://aep.dev/blog/aep-2026-release/) Building software is a team sport, but keeping everyone on the same page is hard. When every team has to invent their own API patterns - deciding how pagination works, or how to format errors - we end up with a lot of wasted effort and systems that don't quite fit together. \[aep.dev\] [The HTTP QUERY Method](https://www.ietf.org/archive/id/draft-ietf-httpbis-safe-method-w-body-14.html) This specification defines the QUERY method for HTTP. A QUERY requests that the request target process the enclosed content in a safe and idempotent manner and then respond with the result of that processing. This is similar to POST requests but can be automatically repeated or restarted without concern for partial state changes. by Julian Reschke \[ietf.org\] [Interactions API: A unified foundation for models and agents](https://blog.google/technology/developers/interactions-api/) Google's Interactions API is a unified interface for interacting with Gemini models and agents. \[blog.google\] [Donating the Model Context Protocol and establishing the Agentic AI Foundation](https://www.anthropic.com/news/donating-the-model-context-protocol-and-establishing-of-the-agentic-ai-foundation) Anthropic is an AI safety and research company that's working to build reliable, interpretable, and steerable AI systems. \[anthropic.com\] [MCP Servers: What We Found When We Actually Looked](https://www.clutch.security/blog/mcp-servers-what-we-found-when-we-actually-looked) Clutch Security analyzed 15,000+ MCP server deployments across enterprises. 38% are unofficial, 86% run locally, 95% invisible to security teams. Full research inside. \[clutch.security\] [One Year of MCP: Looking Back, and Forward](https://thenewstack.io/one-year-of-mcp-looking-back-and-forward/) We hit our share of challenges and lessons learned building around MCP, and we've got a lot of hopes for where it's going next. by Cody De Arkland \[thenewstack.io\] # Business of APIs [How Do You Create a Great Conference Speaker Pitch?](https://nordicapis.com/how-do-you-create-a-great-conference-speaker-pitch/) Learn how to craft a strong conference speaker pitch with clear themes, specific angles, and actionable takeaways to boost your CFP success. by Bill Doerrfeld \[nordicapis.com\] [10 AI-Driven API Economy Predictions for 2026](https://nordicapis.com/10-ai-driven-api-economy-predictions-for-2026/) Explore 2026 predictions on how AI agents, MCP standards, authorization, and new API models will reshape the AI-driven API economy. by Bill Doerrfeld \[nordicapis.com\] [MCP support for Apigee](https://cloud.google.com/blog/products/ai-machine-learning/mcp-support-for-apigee) Apigee now supports MCP and allows enterprises to turn their APIs into MCP servers. \[cloud.google.com\] # (Un)Related [The Sidecar Dilemma: Is Co-Locating MCP Servers with Your API a Security Anti-Pattern?](https://medium.com/@mkipcak/the-sidecar-dilemma-is-co-locating-mcp-servers-with-your-api-a-security-anti-pattern-9b0a42c4347e) The Sidecar Dilemma: Is Co-Locating MCP Servers with Your API a Security Anti-Pattern? In the rapidly evolving landscape of Large Language Models (LLMs) and AI-integrated infrastructure, the Model ... by Mehmet Ali Kฤฑpรงak \[medium.com\] [In 1995, a Netscape employee wrote a hack in 10 days that now runs the Internet](https://arstechnica.com/gadgets/2025/12/in-1995-a-netscape-employee-wrote-a-hack-in-10-days-that-now-runs-the-internet/) Thirty years later, JavaScript is the glue that holds the interactive web together, warts and all. \[arstechnica.com\] ### Upcoming Events *Stay tuned for more events in 2026!* ### Have something to share? As always, if you want to chat, share a link, or make a suggestion, feel free to drop us a quick note or tagging us on Twitter ([@launchany](https://twitter.com/launchany) and [@caseysoftware](https://twitter.com/caseysoftware)) or by emailing us at: [james@launchany.com](mailto:james@launchany.com). [![Twitter](https://cdn-images.mailchimp.com/icons/social-block-v2/outline-light-twitter-48.png)](https://www.twitter.com/launchany) [![LinkedInlinkedin.com/in/jameshigginbotham/](https://cdn-images.mailchimp.com/icons/social-block-v2/outline-light-linkedin-48.png)](http://www.linkedin.com) [![Website](https://cdn-images.mailchimp.com/icons/social-block-v2/outline-light-link-48.png)](https://launchany.com) Want to change how you receive these emails? You can [update your preferences](https://launchany.us2.list-manage.com/profile?u=5005148108dfbac726f74e31e&id=239e48d26e&e=[UNIQID]&c=f8c940fa8e) or [unsubscribe from this list](https://launchany.us2.list-manage.com/unsubscribe?u=5005148108dfbac726f74e31e&id=239e48d26e&t=b&e=[UNIQID]&c=f8c940fa8e). *** ## Discussion No replies yet.