C++ moderne dans le monde des API : REST, GraphQL et gRPC en pratique

Travailler avec les API en C++ : REST, GraphQL, gRPC

Quand il s'agit de créer ou de consommer des API, de nombreux développeurs se tournent par habitude vers Python, Node.js ou Go. Mais que faire si vous avez besoin de performances maximales, d'un contrôle bas niveau sur la mémoire, ou si vous travaillez sur un système legacy où le C++ est roi ? La réponse est simple : le C++ non seulement survit, mais il prospère dans le monde des API. Analysons ensemble les trois approches clés que tout développeur C++ devrait connaître : le classique REST, le moderne GraphQL et le haute performance gRPC.

Cet article n'est pas un manuel aride, mais un guide pratique écrit pour ceux qui veulent écrire du code réel. Nous verrons comment ces technologies sont appliquées en C++, avec des exemples utilisant des bibliothèques populaires, et nous vous aiderons à choisir l'outil adapté à votre tâche.

1. API REST en C++ : un classique revisité

REST (Representational State Transfer) reste le style d'API le plus répandu. On l'apprécie pour sa simplicité, la lisibilité humaine du JSON et sa polyvalence. En C++, nous disposons de plusieurs outils puissants pour travailler avec REST, dont l'un des plus populaires est cpprestsdk (aussi appelé Casablanca) de Microsoft.

Écrire un client REST en C++

Imaginons que nous devions obtenir des données météo depuis une API publique. Voici comment procéder avec cpprestsdk :

#include <cpprest/http_client.h>#include <cpprest/filestream.h>#include <iostream>

using namespace web;using namespace web::http;using namespace web::http::client;

int main() {    // Création du client HTTP    http_client client(U("https://api.openweathermap.org/data/2.5"));

    // Construction de la requête GET avec paramètres    uri_builder builder(U("/weather"));    builder.append_query(U("q"), U("Moscow"));    builder.append_query(U("appid"), U("YOUR_API_KEY"));    builder.append_query(U("units"), U("metric"));

    // Envoi de la requête et réception de la réponse    client.request(methods::GET, builder.to_string())        .then([](http_response response) {            if (response.status_code() == status_codes::OK) {                return response.extract_json();            }            throw std::runtime_error("Échec de la récupération des données");        })        .then([](json::value jsonData) {            std::cout << "Température : "                       << jsonData[U("main")][U("temp")].as_double()                       << "°C" << std::endl;        })        .wait();

    return 0;}

Points clés :

• Asynchrone : cpprestsdk utilise la PPL (Parallel Patterns Library) et les futures, ce qui est idéal pour le C++.
• Gestion du JSON : l'analyseur intégré json::value permet de manipuler facilement les données.
• Multiplateforme : la bibliothèque fonctionne sur Windows, Linux et macOS.

Quand choisir REST ?

REST en C++ est idéal pour :

• Les opérations CRUD simples
• L'intégration avec des services web (réseaux sociaux, systèmes de paiement)
• Le prototypage et les microservices à faible charge

2. GraphQL : la flexibilité des requêtes en C++

GraphQL résout le problème principal de REST — le surchargement (overfetching) et le sous-chargement (underfetching) des données. En C++, pour travailler avec GraphQL, on utilise le plus souvent la bibliothèque cppgraphql ou on écrit son propre client basé sur libcurl.

Exemple de requête GraphQL en C++

Supposons que nous devions obtenir le profil d'un utilisateur et ses derniers articles — en REST, cela nécessiterait deux requêtes, alors qu'en GraphQL, une seule suffit :

#include <iostream>#include <curl/curl.h>#include <nlohmann/json.hpp>

using json = nlohmann::json;

static size_t WriteCallback(void *contents, size_t size, size_t nmemb, void *userp) {    ((std::string*)userp)->a