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

June 20, 2019 - Issue #267
This week's assortment of articles includes misusing HTTP methods, event-driven APIs, shifting from the marketing funnel to the orbit, and lots of goodies for REST and GraphQL fans (with some gRPC thrown in for good measure). Enjoy! -- James
 
Hot Topics
How do you feel about the "misuse" of HTTP methods?
In case you're not sure what the difference between GET and POST in HTTP are (or what that sentence even means), here is a great post from today: It got me thinking that there are definitely situations where folks hack on different methods to create the desired outcome. by Ben Halpern [dev.to]

An API Strategist Explores Event-Driven APIs
Here we go! Fran: I'd say most interesting for me are: loose coupling between services (if a downstream service breaks the others just work fine), they're fault-tolerant since events are queued or stored somewhere, and processed once the service is up and running again, and they allow you to build real-time products easily. by Emmelyn Wang [medium.com]

Why Orbit is better than Funnel for developer relations
The funnel is widely accepted in sales and marketing circles, but despite its popularity, we think it has a few shortcomings when applied to developer relations: It only accounts for the buying journey, and not other kinds of relationships between a company and its audience It assumes a binary relationship with people focused on a purchase, i.e a person is either a lead or not a lead, and if they're not a lead, we don't want to bother with them For certain teams, the funnel remains a useful model. by Josh Dzielak [developermode.com]

From APIStrat to ASC: A New Chapter in API Community Building
Way back in 2012, Kin Lane and I had the whacky idea of starting a vendor neutral API Conference. At the time, there were some early vendor events and they clearly had their own value, but there was nothing that enabled the whole space to gather neutrally. by njyx [area67.org]

draft-dalal-deprecation-header-01 - The Deprecation HTTP Header Field
Network Working Group S. Dalal Internet-Draft Intended status: Standards Track E. Wilde Expires: December 19, 2019 June 17, 2019 The Deprecation HTTP Header Field draft-dalal-deprecation-header-01 Abstract The HTTP Deprecation response header field can be used to signal to consumers of a URI-identified resource that the resource has been deprecated. [tools.ietf.org]

How to work with HTTP JSON APIs in Scala
JSON HTTP APIs have become the standard for any organization exposing parts of their system publicly for external developers to work with. This tutorial will walk you through how to access JSON HTTP APIs in Scala, building up to a simple use case: migrating Github issues from one repository to another using Github's public API. [lihaoyi.com]

bradleyjkemp/grpc-tools
A suite of gRPC debugging tools. Like Fiddler/Charles but for gRPC. - bradleyjkemp/grpc-tools [github.com]

How to set up a powerful API with GraphQL, Koa, and MongoDB - scalability, and testing
So far we achieved basic CRUD functionality. Check out the previous episode before continuing; As our app grows, so does our mutation count. In order to have a clean codebase as we can, we should extract the mutations to dedicated files. This way we can assure our code is modular and separated into maintainable chunks. by Indrek Lasn [codeburst.io]

Securing Your GraphQL API from Malicious Queries
With GraphQL you can query exactly what you want whenever you want. That is amazing for working with an API, but also has complex security implications. Instead of asking for legitimate, useful data, a malicious actor could submit an expensive, nested query to overload your server, database, network, or all of these. by Max Stoiber [blog.apollographql.com]

There Is No Single Right Way To Do APIs
I was wrong. There is no one right way to do APIs. Sure, there are many different processes, practices, and tools that can help you optimize your API operations, but despite popular belief, there is no single "right way" to do define, design, provide, or consume APIs. REST is not the one solution. [apievangelist.com]

CallForCode weather API in Node-RED
I notice there are some changes in the usage of the weather API. For that reason I created a very simple sample with Node-RED to access the weather forecast. The Node-RED flow implements the access to the weather API you can use during your CallForCode challenge. by thomassuedbroecker [suedbroecker.net]

Using Fundamental UI Principles to Design Outstanding APIs
It doesn't take a lot of experience to recognize solid library APIs from less-than-functional ones. When dealing with third-party libraries, programmers can usually quickly grasp if they'll have a hard time using and integrating with them. Most of the time, the difference lies within the API design – at the end of the day, even the most complex problems can easily be solved with a well-designed API. [kite.com]

API Definitions Are Important
Having mature, machine readable API definitions for all API that you depend on, is essential. It also takes a lot of hard work to make happen. It is why I went API define first a long time ago, defining my APIs before I ever get to work designing, mocking, developing, and deploying my APIs. [apievangelist.com]

How to Transform an Air Traffic API to GeoJSON to Render on a Map
Many APIs provide data to use in an application but that data isn't always complete. This tutorial shows how to retrieve data from an API for global flight tracking and then transform it into GeoJSON to store in HERE's XYZ Geospatial Storage API and then render it as a 3D map with Three.js. [programmableweb.com]

What Are the Best DevOps Practices for Enterprise API Builders?
DevOps is not just a technical process, but also an approach to help your team build better software. In this post, we'll cover four important DevOps practices. Using a tool like Postman, you can ensure each of these practices is easily communicated to the rest of your team. [programmableweb.com]
 
The Business of APIs
Tips for building an effective enterprise API programme - Tyk API Gateway and API Management
Building and sustaining an enterprise API programme is challenging. From API design standards to increasing API adoption, there is quite a bit to balance effectively. This article offers some tips that can benefit anyone just starting out to those looking for some additional insights for their established API programme. [tyk.io]

4 Ms of monetization, marketplaces, and APIs
Mike Amundsen recently joined MuleSoft as API Strategy Advisor. Mike is a well-known API expert in the global software engineering community and has authored and co-authored numerous books including "RESTful Web APIs," "Microservice Architecture," and "Continuous API Management," all from O'Reilly. His latest book, "Design and Build Great APIs," will be available through Pragmatic Bookshelf [...] by Mike Amundsen [blogs.mulesoft.com]

How APIs are Powering the Next Industrial Revolution | Nordic APIs |
When someone says "manufacturing," people generally think of old, dingy photographs from the 1920s. Employees are hard at work, leveraging machines and tools to churn out products for society. While that's historically accurate, the factories of today look quite a bit different; people work side by side with machines, using technology to help coordinate manufacturing processes. by Matt Boyle [nordicapis.com]

Cisco's excellent DevNet adventure - SiliconANGLE
Community is important. Whether at work, at school, or at play, the people and culture surrounding us are the keystone to a productive and happy lifestyle. Emphasis on growth through community is very much apparent at Cisco Systems Inc. [siliconangle.com]

Kong 1.2 - Performance Improvements and New OSS Plugins
Today, we're excited to unveil the latest release of our flagship open source offering - Kong 1.2! In this release, we've made key latency and throughput performance improvements and open sourced some previously enterprise-only plugins to enhance your overall Kong experience. by Kong [konghq.com]

(Un)Related Topics
New Hampshire installs first historical marker to honor computer programming
New Hampshire has installed what appears to be the first historical highway marker honoring computer programming, according to the David Brooks at the Concord Monitor. The new sign honors BASIC, Beginner's All-purpose Symbolic Instruction Code, a programming language that was invited at Dartmouth College in 1964. [theverge.com]

Before Netscape: The forgotten Web browsers of the early 1990s
Update: It's Memorial Day weekend here in the US, and the Ars staff has a long weekend accordingly. 2019 marks 30 years since Tim Berners-Lee worked at CERN and came up with a little idea known as the World Wide Web. by Matthew Lasar [arstechnica.com]

When should you be using Web Workers? - DasSur.ma
You should always use Web Workers. And in our current landscape of frameworks it's virtually impossible. Did I get your attention with that? Good. Of course, as with any topic, there is nuance and I will lay that all out. But I have opinions, and they are important. Buckle up. [dassur.ma]

Google Cloud Scheduler is Now Generally Available
In a recent blog, Google announced that customers can now securely invoke HTTP targets on a schedule using Cloud Scheduler - a fully managed cron job service that allows any application to invoke batch, big data, and cloud infrastructure operations. [infoq.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