如何在C语言中调用RESTful API？

RESTful API 是一种基于 HTTP 协议的应用程序接口设计风格，常用于构建网络服务和应用程序。它提供了一种通过标准化的操作和资源访问模式进行客户端与服务器通信的方式。

在C语言中调用RESTful API，通常需要借助一些轻量级的HTTP客户端库来简化操作，以下是几种常见的方法：

1、使用libcurl库

简介：libcurl是一个免费、开源的客户端URL传输库，支持多种协议，包括HTTP和HTTPS，它提供了丰富的功能，如设置请求头、处理响应数据等，适用于各种复杂的网络请求场景。

示例代码：

     #include <stdio.h>
     #include <curl/curl.h>
     size_t write_callback(void *ptr, size_t size, size_t nmemb, void *stream) {
         fwrite(ptr, size, nmemb, (FILE *)stream);
         return size * nmemb;
     }
     int main() {
         CURL *curl;
         FILE *fp;
         CURLcode res;
         curl = curl_easy_init();
         if (curl) {
             fp = fopen("file.html", "wb");
             curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/api/data");
             curl_easy_setopt(curl, CURLOPT_WRITEFUNCTION, write_callback);
             curl_easy_setopt(curl, CURLOPT_WRITEDATA, fp);
             res = curl_easy_perform(curl);
             if (res != CURLE_OK) {
                 fprintf(stderr, "curl_easy_perform() failed: %s
", curl_easy_strerror(res));
             }
             curl_easy_cleanup(curl);
             fclose(fp);
         }
         return 0;
     }

步骤解释：

首先初始化libcurl的CURL对象。

打开一个文件用于保存API返回的数据。

设置要请求的URL为“http://example.com/api/data”。

指定回调函数write_callback来处理服务器返回的数据，并将其写入到文件中。

执行请求，并根据返回结果判断是否成功。

最后清理资源，关闭文件并释放CURL对象。

2、使用restclient-cpp库

简介：restclient-cpp是一个轻量级且易于使用的C++库，专门用于简化对RESTful APIs的调用，它支持多种HTTP方法以及自定义头部信息，还具备自动处理JSON编码/解码和URL编码等功能。

示例代码：

     #include <restclient-cpp/restclient.h>
     #include <iostream>
     int main() {
         std::string response_body;
         auto response_code = RestClient::get("http://example.com/api/data", &response_body);
         if (response_code == 200) {
             std::cout << "Response body:
" << response_body << std::endl;
         } else {
             std::cerr << "Error: GET request failed with code " << response_code << std::endl;
         }
         return 0;
     }

步骤解释：

包含restclient-cpp库的头文件。

使用RestClient::get函数发送GET请求到指定的URL，并将响应体存储在response_body变量中。

根据返回的状态码判断请求是否成功，如果成功则输出响应体，否则输出错误信息。

3、使用civetweb库

简介：civetweb是一个轻量级的Web服务器框架，也可以用来创建HTTP客户端以调用RESTful API，它可以在C环境中处理HTTP请求和响应，适合构建简单的HTTP客户端应用程序。

示例代码：

     #include "civetweb.h"
     #include <stdio.h>
     #include <stdlib.h>
     #include <string.h>
     static void handle_request(struct mg_connection *conn) {
         char *method = (char *)malloc(10);
         char *uri = (char *)malloc(100);
         char *version = (char *)malloc(10);
         char *query_string = (char *)malloc(100);
         char *remote_user = (char *)malloc(100);
         char *remote_addr = (char *)malloc(100);
         char *remote_port = (char *)malloc(10);
         char *local_addr = (char *)malloc(100);
         char *local_port = (char *)malloc(10);
         char *body = (char *)malloc(100);
         size_t body_len = 0;
         mg_get_request_info(conn, method, uri, version, query_string, remote_user, remote_addr, remote_port, local_addr, local_port, &body, &body_len);
         // 在这里可以添加处理请求的逻辑，例如根据URI和方法调用相应的RESTful API
         mg_printf(conn, "HTTP/1.1 200 OK
Content-Type: text/plain
Hello, world!");
         free(method);
         free(uri);
         free(version);
         free(query_string);
         free(remote_user);
         free(remote_addr);
         free(remote_port);
         free(local_addr);
         free(local_port);
         free(body);
     }
     int main(int argc, char **argv) {
         struct mg_server *server = mg_create_server(NULL, handle_request);
         mg_set_option(server, SO_REUSEADDR, "yes");
         mg_bind(server, "8080", NULL);
         printf("Server started on port 8080
");
         while (1) {
             mg_poll(server, 1000);
         }
         mg_destroy_server(&server);
         return 0;
     }

步骤解释：

创建一个civetweb服务器实例，并设置处理请求的回调函数handle_request。

在回调函数中，获取请求的各种信息，如方法、URI、版本等，可以根据这些信息来构造对RESTful API的调用。

这里简单地返回了一个“Hello, world!”的响应，实际应用中应根据具体需求进行处理。

启动服务器并监听端口8080，等待接收请求。

FAQs

1、Q：在C语言中使用libcurl库调用RESTful API时，如何设置请求头？

A：可以使用curl_easy_setopt函数来设置请求头，要设置一个自定义的请求头“Custom-Header”，可以使用以下代码：

     struct curl_slist *headers = NULL;
     headers = curl_slist_append(headers, "Custom-Header: value");
     curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers);

2、Q：restclient-cpp库是否支持异步请求？

A：目前restclient-cpp库主要提供同步的API接口，不支持异步请求，如果需要在C++中进行异步的RESTful API调用，可以考虑使用其他支持异步操作的库，如Boost.Asio等，或者结合多线程来实现异步效果。