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.
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.
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.
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.
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.
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!
API Design Tips And Tricks - What if consumers can't do PATCH, PUT or DELETE?
By Arnaud Lauret, November 7, 2019
There are quite many APIs out there taking advantage of all standard HTTP methods (
DELETE). Unfortunately, there are still some cases where consumers can’t use them all. As far as I know,
POST do not cause any problem at all. But as an API provider, do not take for granted that
PUT and the more dreaded
PATCH HTTP methods can always be used by your consumers. I encountered this problem several times throughout the years and no later than a few weeks ago. Let’s see why and how to solve this problem.
Few things I learned writing The Design of Web APIs
By Arnaud Lauret, November 2, 2019
At last, my book The Design of Web APIs is finished and printed! I gradually got back to a “normal” life since the end of summer as the book entered in its production phase, but it was only when I received the printed copies two weeks ago that I had the feeling that this adventure was really over. And then holding the book in my hands, I wondered if it was worth having spent two years of my life on it, what did I learn spending almost all my free time working on this book? That sounded like a good topic to revive the API Handyman blog.
Explore the OpenAPI Specification 3.0 with the OpenAPI Map
By Arnaud Lauret, March 9, 2018
So you want to explore in depth the OpenAPI Specification version 3.0? You should take the OpenAPI Map with you!
How public web APIs raise software bar
By Arnaud Lauret, February 26, 2018
Now that I have seen brilliant Web APIs that can be used so easily because of their design but also the overall experience some can provide (the famous “DX”) I have become far more demanding and challenging with software in general
Yes. Public web APIs definitely raise software bar. The whole software industry should take example on them …