cpp-httplib v0.42.0
DRAFT

C02. JSONを送受信する

cpp-httplibにはJSONパーサーが含まれていません。JSONの組み立てや解析にはnlohmann/jsonなどのライブラリを使ってください。ここではnlohmann/jsonを例に説明します。

JSONを送信する

httplib::Client cli("http://localhost:8080");

nlohmann::json j = {{"name", "Alice"}, {"age", 30}};
auto res = cli.Post("/api/users", j.dump(), "application/json");

httplib::Client cli("http://localhost:8080");

nlohmann::json j = {{"name", "Alice"}, {"age", 30}};
auto res = cli.Post("/api/users", j.dump(), "application/json");

Post()の第2引数にJSON文字列、第3引数にContent-Typeを渡します。Put()やPatch()でも同じ形です。

Warning: 第3引数のContent-Typeを省略すると、サーバー側でJSONとして認識されないことがあります。"application/json"を必ず指定しましょう。

JSONレスポンスを受け取る

auto res = cli.Get("/api/users/1");
if (res && res->status == 200) {
  auto j = nlohmann::json::parse(res->body);
  std::cout << j["name"] << std::endl;
}

auto res = cli.Get("/api/users/1");
if (res && res->status == 200) {
  auto j = nlohmann::json::parse(res->body);
  std::cout << j["name"] << std::endl;
}

res->bodyはstd::stringなので、そのままJSONライブラリに渡せます。

Note: サーバーがエラー時にHTMLを返すことがあります。ステータスコードを確認してからパースすると安全です。また、APIによってはAccept: application/jsonヘッダーが必要です。JSON APIを繰り返し呼ぶならC03. デフォルトヘッダーを設定するが便利です。

サーバー側でJSONを受け取って返す方法はS02. JSONリクエストを受け取りJSONレスポンスを返すを参照してください。

ESC