include.image_alt

7 ways leading to wrong ownership and killing APIs

By Arnaud Lauret, March 28, 2021

After hundreds of API design reviews, I can tell that the most neglected aspect of API governance is ownership. Unfortunately, that’s probably the most important one. Without true ownership, your APIs will probably be totally wrong. Without true ownership, your employees will be terribly sad or leave. Without true ownership, your company may even die. As an API design reviewer, I believe that my role is also to warn the teams I’m working with about this topic and help them to fix the problem.

include.image_alt

The Augmented API Design Reviewer

By Arnaud Lauret, December 13, 2020
API Design Reviews can be a total nightmare when it comes to check API Design Guidelines conformance. Hopefully, this can be automated using the OpenAPI Specification and Spectral, helping you to focus on real API design matters.
include.image_alt
API Days Interface 2020 Series - Part 2

Doing APIs right and doing right APIs

By Arnaud Lauret, July 26, 2020

API Days Interface being online made the experience a bit different but after 3 days, I felt almost as usual; exhausted and my brain boiling. In previous post, I shared my feelings about my first online conference. Now let’s talk about the content; Sam Newman doing a facepalm, API design, architecture, governance and my new favorite quote “Doing APIs right, doing right APIs”.

include.image_alt
API Days Interface 2020 Series - Part 1

Speaking into the void

By Arnaud Lauret, July 8, 2020

I’ve attended and spoke at API Days Interface online conference on June 20, July 1 & 2, 2020. Being online made the experience a bit different but after almost 3 days, I felt almost as usual; exhausted and my brain boiling with all what I’ve heard and seen. In this first post I share my feelings about attending and speaking at an online conference.

include.image_alt
JQ and OpenAPI Series - Part 4

Bonus: Coloring JQ's raw output

By Arnaud Lauret, July 6, 2020

Ever wanted to quickly find, extract or modify data coming from some JSON documents on the command line? JQ is the tool you’re looking for. The three previous parts of this JQ and OpenAPI Series, taught us to extract data from JSON (OpenAPI) files and modify them using many filters, creating modules and using command line arguments. To finish this series, we’ll learn to color JQ’s raw terminal output and do a colored version of part 2’s search operations.

include.image_alt
JQ and OpenAPI Series - Part 3

Modifying OpenAPI files with JQ

By Arnaud Lauret, June 28, 2020

Ever wanted to quickly find, extract or modify data coming from some JSON documents on the command line? JQ is the tool you’re looking for. Thanks to the two previous parts of this JQ and OpenAPI Series, we learned how to extract data from JSON (OpenAPI) files by discovering many filters, creating modules and using command line arguments. Now we will discover how to modify them; how to replace, add or delete elements in processed documents.

include.image_alt

APIs You Won't Hate Podcast - The API Handyman Cometh

By Phil Sturgeon, Matt Trask & Arnaud Lauret, March 24, 2020

It was great to chat with Phil Sturgeon and Matt Trask on the APIs You Won’t Hate Podcast. We talked about API Design and Reviews, and we also talk about life in quarantine, as France completely shut down and how Phil made it back in time to England before the lock downs took place.

include.image_alt
JQ and OpenAPI Series - Part 2

Using JQ command line arguments, functions and modules

By Arnaud Lauret, February 3, 2020

Ever wanted to quickly find, extract or modify data coming from some JSON documents on the command line? JQ is the tool you’re looking for. In the previous part of this JQ and OpenAPI Series, we learned to invoke JQ and how to extract data from JSON documents using some of its many filters. Now we will discover how to build flexible and easily reusable JQ filters by creating functions and modules and also using command line arguments.

include.image_alt
JQ and OpenAPI Series - Part 1

Using JQ to extract data from OpenAPI files

By Arnaud Lauret, January 15, 2020

Ever wanted to quickly find, extract or modify data coming from some JSON documents on the command line? JQ is the tool you’re looking for. In this 4 parts post series, you’ll discover why and how I use JQ with OpenAPI Specification files. But more important, you’ll get some basic and more advanced example of how to use JQ on any JSON document to get and modify JSON data as you want. In this first part we’ll focus on what is JQ, why I use it with OpenAPI files and we’ll learn how to invoke JQ and discover some of the many JQ filters that can be used to extract data from JSON.

include.image_alt

I'd Rather Be Writing Podcast - API Design and Usability

By Tom Johnson & Arnaud Lauret, December 7, 2019

I had the pleasure to chat with Tom Johnson for his I’d Rather Be Writing Podcast. We talked about my book, The Design of Web APIs, and specifically best practices for designing web APIs and focus on the roles technical writers can play.

By continuing to use this web site you agree with the API Handyman website privacy policy (effective date , June 28, 2020).