Blog Contact

RefCard RESTful API Design

En bref.

To facilitate and accelerate the design and development of your APIs, we share our vision and beliefs with you in this Reference Card. They come from our direct experience on API projects.


As soon as we start working on an API, design issues arise. A robust and strong design is a key factor for API success. A poorly designed API will indeed lead to misuse or – even worse – no use at all by its intended clients: application developers.

“Purists” insist upon following REST principles without compromise. “Pragmatics” prefer a more practical approach, to provide their clients with a more usable API. The proper solution often lies in between.

Designing a REST API raises questions and issues for which there is no universal answer. REST best practices are still being debated and consolidated, which is what makes this job fascinating.


Au menu :

> RESTful API principles as described in the literature (Roy Fielding, Leonard Richardson, Martin Fowler, HTTP specification...)

> The API practices of the Web Giants

> Nowadays, two opposing approaches are seen.

Veuillez remplir les informations suivantes pour qu'un lien de téléchargement vous soit envoyé.

Votre nom est obligatoire

Votre prénom est obligatoire

Exemple : [email protected]

Votre titre est obligatoire

Votre société est obligatoire

*Champs obligatoires

J'adore ce que vous faites ! Tenez-moi au courant de vos news.

Vous devez accepter les conditions



Votre demande a bien été envoyée,
veuillez consulter la boîte de réception de votre messagerie.