The week in API strategy, news, articles, and upcoming events.
James Higginbotham, Curator  A hand-curated weekly newsletter for API developers, sponsored by LaunchAny and CaseySoftware

Find this via Twitter? Subscribe now so you don't miss out

API Developer Weekly

Dec 5, 2019 - Issue #288
This week's articles feature discussions around demoing APIs to non-developers, API versioning, and DevOps-friendly documentation. Also featured is a great introduction to JSON-LD and some deep-dive into API gateways vs. service mesh. Happy reading! -- James
Hot Topics
Lessons learned while demoing API to non-developers
What would you do if you had to demo API to non-developers in a highly-constrained context? How would you do without curl, Postman or any other API tool usually used? How would you do without your usual fun API examples? by Arnaud Lauret []

Product and Business Considerations of API Versioning
Every API product manager is ultimately faced with the critical question: "When and how do I version my API?" If you search the web for guidance, you most often find resources on whether to version in the URL or header. While a critical step along the path, there are many factors often ignored by these articles. by James Higginbotham []

The Differences Between Gateway, Microgateway, and Service Mesh
APIs are complex. Each component would be complex on its own, but when these APIs communicate with one another, this complexity is only compounded. Add in external clients, and you have an intricate web of cross-communicating codebases, competing paths for information, and separate sources of truth. by Kristopher Sandoval []

Generating API clients based on OpenAPI v3 specifications
Microservice architecture is one of the recent buzzwords in the world of software development. It can help create scalable, robust software even in complex business domains. However, it introduces additional operational complexity among which is communication between many services. Regarding service-to-service communication, there are several questions to answer: which protocol(s) should we use? []

An Introduction to JSON-LD
I've been spending some time recently thinking about ways to maintain loose coupling between lots of different teams. I suspect this involves thinking about shared protocols between the teams (i.e. having well-defined interactions) more than worrying about internal "implementations" like what flavor of Agile you use or what programming language you write in. by Jon Moore []

DevOps-friendly Docs Publishing for APIs
Here at Cisco, we have a developer program called DevNet that focuses on making Cisco APIs easier to use as well as work with developers and Cisco partners in many technology areas including IoT... by Anne Gentle []

A hacking group is hijacking Docker systems with exposed API endpoints
A hacking group is currently mass-scanning the internet looking for Docker platforms that have API endpoints exposed online. The purpose of these scans is to allow the hacker group to send commands to the Docker instance and deploy a cryptocurrency miner on a company's Docker instances, to generate funds for the group's own profits. by Catalin Cimpanu []

Creating Your First API Gateway In The Oracle Cloud
In this post, we'll look at getting started with the Oracle API Gateway including the necessary cloud networking configuration, creating and deploying a simple serverless function and creating a gateway and deployment to front that serverless function. by Todd Sharp []

Validating event-driven messaging between Node.js services using AsyncAPI
In this blog post, you'll read about what is AsyncAPI and how at relayr we use it for validation of documentation of messaging between dozens of Node.js services. Let's first talk a little about OpenAPI and Swagger. The Swagger specification was founded back in 2010 as a design specification for RESTful APIs. []

The Business of APIs
Bootstrapped Podcast #117: Selling to Developers
Ed and I talk about the things that work - and don't work - when you product is targeted towards developers. []

What is the value of planning?
Winston Churchill once said "Plans are of little importance, but planning is essential." What Churchill meant was that the value is in thinking something through, in planning it, before you do it. []

How API Management improves ASI
The secret lies in the enablers of a technology that is simple, scalable and widespread. The 4.0 Industry requires more than ever the integration between machines, automation sensors and the management systems of a company. by Julio Fernandes []
(Un)Related Topics
Google Cloud gets new security smarts across data encryption, network security, and more
Google has announced a number of notable new tools and services as the internet giant doubles down on enterprise security across its cloud products. The announcements were made in London at the U.K. incarnation of its annual Google Cloud Next conference. The first of these new tools, which will be launching in beta shortly, is called External Key Manager. by Paul Sawers []

Microsoft Announces 1.0 Release of Kubernetes-Based Event-Driven Autoscaling (KEDA)
Microsoft has announced the 1.0 version of the Kubernetes-based event-driven autoscaling (KEDA) component, an open-source project that can run in a Kubernetes cluster to provide "fine grained autoscaling (including to/from zero)" for every container. KEDA also serves as a Kubernetes Metrics Server and allows users to define autoscaling rules using a dedicated Kubernetes custom resource. []

Designing Systems - Efficiency vs Flexibility
(this post was originally published on the Haufe Development Blog) This blog post was inspired by a deployment tool discussion while drafting engineering blueprints to converge the organization on common application patterns. Since I have been in this kind of discussions repeatedly, I wanted to take the time to write down some thoughts about tradeoffs in system design. by Holger Reinhardt []

'Laziness has won': apostrophe society admits its defeat
A society dedicated to preserving the "much-abused" apostrophe is to be shut down as its chairman said "ignorance and laziness" had won. John Richards, who worked in journalism for much of his career, started the Apostrophe Protection Society in 2001 after he retired. by PA Media []

Useful Resources
Upcoming Web API Events
A list of upcoming Web API Events, maintained by Matthew Reinbold

API Security Events
A list of upcoming API security events from

Tyk Whitepaper: Approaching your API Strategy
As well as writing for the James Higginbotham is an Executive API Consultant with experience in API strategy and software architecture. James guides enterprises through their digital transformation journey to deliver a great customer experience and provides training in API and microservice design. []

Book: A Practical Approach to API Design by Casey and Higginbotham
If you read the tech press, everyone knows they need an API but most aren't really sure what it is. They treat it as another checkbox like "Web 2.0" was a few years ago or a mobile app was most recently. In fact, there’s an entire “API-first” movement in development circles that most people don’t understand or even realize why. In this book, we'll start by discussing the what an API is, why you might need one, and follow up with the how to build one. []
Want to share something?
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 and @caseysoftware) or by emailing us at:
Follow on Twitter    Forward to Friend    Subscribe
Copyright © 2019 LaunchAny, All rights reserved.
unsubscribe from this list