Copy
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

Nov 7, 2019 - Issue #284
This week, we have articles that will help us generate client-side code from our API descriptions, APIs vs. ODBC/JDBC, and the emergence of GraphQL versioning. Happy reading! -- James
 
Hot Topics
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? [98elements.com]

Why Are APIs Better Than Direct ODBC / JDBC Connections?
I had someone email me a question the other day, asking about how they should respond when someone asks them why APIs are a better choice that using a direct ODBC / JDBC database connection. Before I wrote a piece on it I wanted to tap my network of API geeks to see what other opinions might be lurking out there. by Kin Lane [apievangelist.com]

How Should We Version GraphQL APIs?
How do you version GraphQL APIs? The most common answer you'll get these days is "you don't". If you're like me when I first read that, you might be a little anxious about maintaining a version-less API or a bit skeptical of the approach. [productionreadygraphql.com]

How to Mock API Calls in Test Environments | Stoplight API Corner
Automated testing is a great way to ensure the quality of your software. It helps you identify what behaviors you expect to see, and gives you an explicit statement about what went wrong if you encounter a bug. These days, APIs are everywhere, but integrating APIs into unit tests can be a little tricky. [stoplight.io]

AWS APIs and Extending Style in OpenAPI
Recently, I gave a talk at the API Specifications Conference in Vancouver, BC. The talks were not recorded, but attendees and people following along online found it interesting how we are using OpenAPI extensions at Transposit and how some of these extensions might be useful for the future progression of the OpenAPI Specification. [transposit.com]

draft-cedik-http-warning-00 - Communicating Warning Information in HTTP APIs
Network Working Group A. Cedik Internet-Draft shipcloud GmbH Intended status: Standards Track E. Wilde Expires: May 7, 2020 Axway November 4, 2019 Communicating Warning Information in HTTP APIs draft-cedik-http-warning-00 Abstract This document defines a warning code and a standard response format for warning information in HTTP APIs. [tools.ietf.org]

Just Curl it
A talk given by Daniel Stenberg, founder & lead developer of Curl at the 2019 Platform Summit in Stockholm. Everyone uses curl. There are good uses, some bad uses and some lesser known gems that are good to know. by Nordic APIs [youtube.com]

The Two Most Important Challenges with an API Gateway when Adopting Kubernetes | Ambassador
Building applications using the microservices pattern and deploying these services onto Kubernetes has become the de facto approach for running cloud-native applications today. In a microservice architecture, a single application is decomposed into multiple microservices. Each microservice is owned by a small team that is empowered and responsible to make the right decisions for the specific microservice. [getambassador.io]
  
The Business of APIs
7 Mantras For Quality Developer Experience | Nordic APIs |
Developer Experience is a crucial aspect of modern-day API ownership. With fierce competition between API providers in almost every industry, it's no longer about what your API can do, but what it takes for developers to do. And yet, getting Developer Experience right still feels like 21st-century black magic to some... by Thomas Bush [nordicapis.com]

Why Your Enterprise Keeps Failing At Digital Transformation
Digital transformation has been pivotal to General Electric's (GE) corporate strategy for years. The company first announced its Predix industrial software platform in 2013 and has since positioned itself as a " digital industrial" company. Though GE started to cover ground toward its digital transformation goals and began generating revenue from the Predix platform, the company ultimately failed to drive an organization-wide evolution. by Lou Powell [forbes.com]

US Bank launches API portal for third-party developers
U.S. Bank launched a suite of API tools this week to support third-party app developers in their efforts to build services that can securely connect to U.S. Bank account information. In an apparent shift from the traditional, walled-garden approach of large banks, U.S. Bank's developer portal enables developers to build apps that may compete with [...] [bankinnovation.net]
 
(Un)Related Topics
Testing Microservices: 6 Case Studies With a Combination of Testing Techniques - Part 3
An important consideration when testing microservices is how to manage the associated dependencies. Various techniques can be used to decouple dependencies, but they all have tradeoffs that development/QA teams must be aware of. Architects, developers, and QA teams must work together to understand and specify the testing goals, context, and current constraints. [infoq.com]

Kubernetes Patterns
The way developers design, build, and run software has changed significantly with the evolution of microservices and containers. These modern architectures use new primitives that require a different set of practices than most developers, tech leads, and architects re accustomed to. [redhat.com]

ynqa/ktop
A visualized monitoring dashboard for Kubernetes. kubectl also has top subcommand, but it is not able to: Watch usages regularly for Pod/Node Compare the usage of Pod resources with Node or limits/requests ktop resolves these problems and has a more graphical dashboard. by ynqa [github.com]

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

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. [content.tyk.io]


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. [leanpub.com]

 
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: james@launchany.com
 
Follow on Twitter    Forward to Friend    Subscribe
Copyright © 2019 LaunchAny, All rights reserved.
unsubscribe from this list