include.image_alt

Read How to Provide APIs With an Existing Information System on Nordic APIs blog

By Arnaud Lauret, August 4, 2015

If you want to know why an existing IS is not a good API, you should read my last post on Nordic APIs blog How to Provide APIs With an Existing Information System.

include.image_alt

Read Should Every Company Consider Providing an API? on Nordic APIs blog

By Arnaud Lauret, June 10, 2015

My other self Arnaud Lauret writes about APIs too. This week you can read Should Every Company Consider Providing an API? on Nordic APIs blog.

include.image_alt

Do you really know why you prefer REST over RPC?

By Arnaud Lauret, May 10, 2015

A few weeks ago I’ve seen an interesting flock of tweets initiated by this question:

This question and the tweets that followed put my brain on quite an animated discussion…

include.image_alt

The data, the hypermedia and the documentation

By Arnaud Lauret, April 24, 2015

When I look at hypermedia media-types and API definition languages I feel that the frontier between data and documentation is becoming thinner as my knowledge of the API world grows and as the API world evolves.

include.image_alt

The API crash test project

By Arnaud Lauret, April 5, 2015

As I was writing my HAMM and ways of API smartness posts, I wanted more. As I was discussing with smart people about APIs, I wanted ever more. I want to delve deeply into the API ways.

include.image_alt

The ways of the API smartness

By Arnaud Lauret, March 28, 2015

An API must be smart to ensure that consumers will want to use it and remain dumb when they consume it.

include.image_alt
Hypermedia API maturity model Series - Part

Part II – The missing links

By Arnaud Lauret, March 15, 2015

Hypermedia is not only a conceptual and philosophical subject of interesting and animate debates among the API community, it’s also a concrete solution we can use to cover concrete needs. In this second part of hypermedia API maturity model (HAMM) series I will talk about my own experience to expose two missing (in my humble opinon) notions in common implementations and include these missing links in an updated version of the HAMM.

include.image_alt
Hypermedia API maturity model Series - Part

Part I - Hypermedia-ness

By Arnaud Lauret, February 28, 2015

When we talk about hypermedia for an API, we’re talking about making it discoverable or browsable. Adding hypermedia to an API potentially brings flexibility, loose coupling, better human readability on the fly and even machine readability on the fly. But nowadays, the hypermedia area for APIs is still a work in progress and it can be implemented in many ways leading to different levels of hypermedia-ness.

include.image_alt

The beautiful API and the bestial back-office

By Arnaud Lauret, February 16, 2015

When you design an API (even an internal/private one) upon an existing back office (to plug a mobile application on it for example), you should take care of one thing: an API is a display, not a window. An API’s purpose is to expose your data and data processing but an API is only a representation and you’re under no obligation to directly expose the crude reality.

include.image_alt

Why you must design your private API in english

By Arnaud Lauret, February 7, 2015

Why you must design your private API in english.
Pourquoi vous devez concevoir votre API privée en anglais.
Perché è necessario progettare la vostra API privata in inglese.
Por qué debe diseñar su API privada en Inglés.
Deshalb müssen Sie Ihre private API in Englisch entwerfen.
なぜあなたは英語であなたのプライベートAPIを設計する必要があります.

As you might have guess, this post targets people designing APIs in non english speaking countries. When you design an API there are many little things that you risk to forget or not take into account, especially when this API is private/internal, and later you may bitterly regret it. Choosing a language for your API is one of them.

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