include.image_alt

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

By Phil Sturgeon, Matt Trask & Arnaud Lauret, July 9, 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
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 last week. 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

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

By Tom Johnson & Arnaud Lauret, July 8, 2020

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.

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

API Design Reviewer's Starter Set

By Arnaud Lauret, June 29, 2020
Explore subterranean needs! Plunder hoards of inconsistency! Battle legendary design flaws! The API Design Reviewer’s Starter Set is your gateway to exhaustive and constructive API design reviews. It contains the essential rules of design reviews plus a few tips and trick that will be of great help on your perilous adventures in the API world.
include.image_alt

The Design of Everyday APIs

By Arnaud Lauret, June 28, 2020
Well-designed APIs are a joy to use; poorly-designed APIs are cumbersome, confusing and frustrating, just like everyday things. During this session, I make a parallel between everyday things design and API design to expose simple but fundamentals design principles.
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
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

Lessons learned while demoing API to non-developers

By Arnaud Lauret, November 22, 2019

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? I had to do that a few weeks ago and was quite happy by the questions that arose and the solutions found. The whole story definitely deserves a post in order to share what I’ve learned!

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