C++ REST SDK快速上手指南（零基础学会使用cpprestsdk进行HTTP通信）

一、什么是cpprestsdk？

cpprestsdk 是一个跨平台的C++库，支持 Windows、Linux 和 macOS。它基于 C++11 标准，提供了一套简洁的 API，用于：

• 发送 HTTP GET/POST/PUT/DELETE 请求
• 解析和生成 JSON 数据
• 处理 URI 和 MIME 类型
• 实现异步非阻塞 I/O 操作

无论你是想调用 RESTful API、爬取网页数据，还是构建微服务客户端，C++ REST SDK入门 都是你不可错过的选择。

二、安装 cpprestsdk

不同平台的安装方式略有不同：

Windows（使用 vcpkg）

vcpkg install cpprestsdk

Ubuntu / Debian

sudo apt-get install libcpprest-dev

macOS（使用 Homebrew）

brew install cpprestsdk

三、第一个 cpprestsdk 程序：发送 HTTP GET 请求

下面是一个完整的示例，演示如何使用 cpprestsdk 向一个公开的 JSON API 发送 GET 请求，并打印响应内容。

#include <iostream>#include <cpprest/http_client.h>#include <cpprest/filestream.h>using namespace utility;using namespace web;using namespace web::http;using namespace web::http::client;int main(){    // 创建一个 http_client 对象，指定目标 URL    http_client client(U("https://jsonplaceholder.typicode.com/posts/1"));    // 发送 GET 请求并等待响应    client.request(methods::GET)        .then([](http_response response) {            // 检查状态码是否为 200 OK            if (response.status_code() == status_codes::OK)            {                // 获取响应体作为字符串                return response.extract_string();            }            else            {                std::cerr << "请求失败，状态码: "                           << response.status_code() << std::endl;                return std::string("");            }        })        .then([](std::string responseBody) {            if (!responseBody.empty())            {                std::cout << "响应内容:\n" << responseBody << std::endl;            }        })        .wait(); // 等待异步操作完成（仅用于示例，生产环境慎用）    return 0;}

这段代码展示了典型的 cpprestsdk HTTP请求 流程：创建客户端 → 发送请求 → 处理响应。注意，cpprestsdk 使用了 C++ 的 pplx::task 异步模型（类似 Promise），通过 .then() 链式调用处理结果。

四、编译你的程序

假设你的源文件名为 main.cpp，可以使用以下命令编译：

Linux / macOS

g++ -std=c++11 main.cpp -lboost_system -lssl -lcrypto -lcpprest -pthread -o myapp

Windows（Visual Studio）

在 Visual Studio 中，确保已通过 vcpkg 安装 cpprestsdk 并集成到项目中，然后直接编译即可。链接器会自动处理依赖。

五、进阶：发送 POST 请求并处理 JSON

除了 GET，你还可以发送 POST 请求并附带 JSON 数据：

// 构建 JSON 对象json::value postData;postData[U("title")] = json::value::string(U("Hello from C++"));postData[U("body")] = json::value::string(U("This is a test post."));postData[U("userId")] = json::value::number(1);http_client client(U("https://jsonplaceholder.typicode.com/posts"));client.request(methods::POST, U(""), postData.serialize(), U("application/json"))    .then([](http_response response) {        std::cout << "POST 响应状态: "                   << response.status_code() << std::endl;        return response.extract_json();    })    .then([](json::value jsonResponse) {        std::wcout << L"服务器返回的 ID: "                     << jsonResponse.at(U("id")).as_integer() << std::endl;    })    .wait();

这体现了 C++网络编程 中与 REST API 交互的典型模式：构造 JSON → 设置 Content-Type → 发送请求 → 解析返回的 JSON。

六、总结

通过本教程，你已经掌握了 cpprestsdk 的基本用法，包括安装、发送 GET/POST 请求、处理 JSON 数据等核心技能。虽然它依赖于 Boost 和 OpenSSL，但其简洁的 API 设计大大降低了 C++ 网络编程的门槛。

建议你动手尝试修改示例代码，连接你自己的 API 或公开测试接口，加深理解。未来你还可以探索 WebSocket、文件上传、自定义 Header 等高级功能。

希望这篇 cpprestsdk教程 能为你打开 C++ 网络开发的大门！