How to deal with API clients, the lazy way — from code generation to release management

By on August 1, 2020
Pin It

 

The Arduino IoT Cloud platform aims to make it very simple for anyone to develop and manage IoT applications and its REST API plays a key role in this search for simplicity. The IoT Cloud API at its core consists of a set of endpoints exposed by a backend service, but this alone is not enough to provide a full-fledge product to your users. What you need on top of your API service are:

  • Good documentation explaining how to use the service.
  • A number of plug-and-play API clients that can be used to abstract the API from different programming languages.

Both those features are difficult to maintain because they get outdated pretty easily as your API evolves but clients are particularly challenging: they’re written in different programming languages and for each of those you should provide idiomatic code that works and is distributed according to best practices defined by each language’s ecosystem.

More info

About Emanuele Signoretta

Studying electronics and communication engineering at Politecnico di Torino. Electronics, IT and Open Source enthusiast.

Leave a Reply

Your email address will not be published. Required fields are marked *