C++如何利用C++调用Web API并解析返回的JSON-C++-PHP中文网

用libcurl发起http请求是最直接方案，需正确初始化、设置选项、捕获响应、解析json并分层处理网络/http/业务错误。

c++如何利用c++调用web api并解析返回的json

用 `libcurl` 发起 HTTP 请求是最直接的方案

标准 C++ 没有内置 HTTP 客户端，libcurl 是跨平台、稳定、生产可用的选择。它不依赖 Boost 或现代 C++20 特性，Windows/macOS/Linux 都能快速编译接入。

常见错误是直接用 std::system("curl ...")：不可控、难调试、无法捕获响应体、无法处理重定向或超时。必须用 libcurl 的 C API 封装调用。

实操建议：

chartjs-reporter

此技能用于在用户需要将结构化数据（查询结果、CSV 摘要、JSON 记录或 Python 字典/列表）转换为独立的 HTML 页面时使用。

下载

Windows 下推荐用 vcpkg 安装：vcpkg install curl:x64-windows；macOS 用 brew install curl；Linux 用 sudo apt install libcurl4-openssl-dev
初始化必须调用 curl_global_init(CURL_GLOBAL_DEFAULT)，且只需一次（通常在 main 开头）
每个请求应创建独立的 CURL* 句柄，设置 CURLOPT_URL、CURLOPT_HTTPGET、CURLOPT_TIMEOUT 等关键选项
用 CURLOPT_WRITEFUNCTION + CURLOPT_WRITEDATA 捕获响应体到 std::string，而非依赖 CURLOPT_HEADER 或 stdout 重定向

用 `nlohmann/json` 解析 JSON 响应最省心

手动解析 JSON 字符串容易出错（如嵌套对象越界、类型误判、编码问题），nlohmann/json 是 header-only 库，支持直接从 std::string 构造，语法接近 Python。

典型陷阱是忽略返回值校验：API 返回 200 但 body 是 {"error":"not found"}，或字段缺失导致 json["data"]["items"] 报 out_of_range 异常。

实操建议：

始终用 try { json j = json::parse(response_str); } catch (const json::parse_error&) { /* 处理非法 JSON */ }
访问嵌套字段前检查存在性：if (j.contains("data") && j["data"].is_object()) { ... }
用 j.value("count", 0) 提供默认值，避免 j["count"].get<int>()</int> 在字段不存在时抛异常
若 API 返回数组，用 for (const auto& item : j["items"]) { ... } 迭代，别硬写 j["items"][i] 循环

HTTP 错误码和网络异常必须显式处理

很多代码只检查 curl_easy_perform() 返回值是否为 CURLE_OK，却忽略 HTTP 状态码（如 401、404、503）。libcurl 默认不把非 2xx 当作错误，需手动读取 CURLINFO_RESPONSE_CODE。

更隐蔽的问题是 DNS 失败、连接超时、SSL 证书验证失败——这些会触发 CURLE_COULDNT_RESOLVE_HOST 等错误，但不会产生有效 JSON 响应。

实操建议：

调用 curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code) 获取真实状态码，再判断是否在 200–299 范围
设置 CURLOPT_FAILONERROR 为 1L 可让 libcurl 对 4xx/5xx 自动返回错误（但注意：某些 API 用 400 表示业务失败，此时不该中断）
务必设置 CURLOPT_CONNECTTIMEOUT 和 CURLOPT_TIMEOUT，否则默认无超时，卡死在线程里
SSL 场景下，开发期可设 CURLOPT_SSL_VERIFYPEER 为 0L（跳过证书验证），但上线必须恢复为 1L 并配好 CA bundle 路径（CURLOPT_CAINFO）

完整最小可运行示例（含错误防护）

以下代码片段整合了上述要点，仅依赖 libcurl 和 nlohmann/json，无额外封装：

#include <iostream>
#include <string>
#include <curl>
#include <nlohmann><p>size_t write_callback(void<em> ptr, size_t size, size_t nmemb, std::string</em> data) {
size_t real_size = size <em> nmemb;
data->append((char</em>)ptr, real_size);
return real_size;
}</p>
<p>int main() {
curl_global_init(CURL_GLOBAL_DEFAULT);
CURL* curl = curl_easy_init();
if (!curl) return -1;</p>
<pre class="brush:php;toolbar:false;">std::string response;
curl_easy_setopt(curl, CURLOPT_URL, "https://httpbin.org/get");
curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
curl_easy_setopt(curl, CURLOPT_WRITEDATA, &response);
curl_easy_setopt(curl, CURLOPT_TIMEOUT, 10L);
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L);

CURLcode res = curl_easy_perform(curl);
long http_code = 0;
curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &http_code);

curl_easy_cleanup(curl);
curl_global_cleanup();

if (res != CURLE_OK || http_code = 300) {
    std::cerr <p>}</p>

真正复杂的地方不在调用本身，而在于如何区分网络层失败、HTTP 层失败、业务逻辑失败——这三类错误需要不同策略（重试、告警、用户提示），但很多人只写了一个 if (res != CURLE_OK) 就以为搞定了。