Запросы к REST API на Си

Введение

В стандартной библиотеке Си нет HTTP-клиента. Но REST API — это текстовый протокол поверх TCP, а TCP в Си есть: сокеты POSIX, socket, connect, send и recv. Запрос собирается как строка, ответ читается как строка.

Так можно работать с http://: локальный сервис, тестовый стенд, внутренняя сеть. Для https:// нужен TLS, а его в Си без библиотеки нет: берут OpenSSL или libcurl. libcurl — это библиотека, а не часть языка; на ней REST-запросы пишут в обычном проекте, а на сокетах — когда библиотеку подключить нельзя и нужен только http.

Как тот же запрос выглядит на C++ с libcurl, RAII и std::string — страница про REST на C++.

Ниже — рабочая программа, которая отправляет запрос и печатает ответ целиком, и вывод, который она дала на локальном тестовом сервере.

Тестовый сервер

Без интернета запросы проверяют на своём сервере. Простейший вариант — http.server из Python: он отдаёт файлы текущего каталога и понимает только GET.

python3 -m http.server 8000

Команда занимает терминал, поэтому запросы шлём из второго. Для POST, PUT и DELETE нужен обработчик, который их принимает: файл server.py в том же каталоге отвечает кодом и отдаёт обратно тело запроса.

from http.server import BaseHTTPRequestHandler, HTTPServer class Handler(BaseHTTPRequestHandler): def answer(self, code, body=""): self.send_response(code) self.send_header("Content-Type", "application/json") self.send_header("Content-Length", str(len(body))) self.end_headers() self.wfile.write(body.encode()) def do_GET(self): self.answer(200, '{"status": "ok"}') def do_POST(self): body = self.rfile.read(int(self.headers.get("Content-Length", 0))) self.answer(201, '{"created": ' + body.decode() + '}') def do_PUT(self): body = self.rfile.read(int(self.headers.get("Content-Length", 0))) self.answer(200, '{"replaced": ' + body.decode() + '}') def do_DELETE(self): self.answer(204) HTTPServer(("127.0.0.1", 8001), Handler).serve_forever()

python3 server.py

GET

Порядок вызовов один для любого метода: getaddrinfo переводит адрес и порт в структуру, socket создаёт сокет, connect открывает соединение, send отправляет текст запроса, recv читает ответ до закрытия соединения.

Файл rest.c:

#include <netdb.h> #include <stdio.h> #include <stdlib.h> #include <string.h> #include <sys/socket.h> #include <unistd.h> int main(int argc, char *argv[]) { if (argc < 3) { fprintf(stderr, "usage: %s METHOD PATH [BODY]\n", argv[0]); return 2; } const char *method = argv[1]; const char *path = argv[2]; const char *body = (argc > 3) ? argv[3] : ""; struct addrinfo hints = {0}; struct addrinfo *res; hints.ai_family = AF_INET; hints.ai_socktype = SOCK_STREAM; if (getaddrinfo("127.0.0.1", "8001", &hints, &res) != 0) { perror("getaddrinfo"); return 1; } int fd = socket(res->ai_family, res->ai_socktype, res->ai_protocol); if (fd < 0 || connect(fd, res->ai_addr, res->ai_addrlen) != 0) { perror("connect"); return 1; } char request[1024]; snprintf(request, sizeof(request), "%s %s HTTP/1.1\r\n" "Host: 127.0.0.1:8001\r\n" "Accept: application/json\r\n" "Content-Type: application/json\r\n" "Content-Length: %zu\r\n" "Connection: close\r\n" "\r\n" "%s", method, path, strlen(body), body); send(fd, request, strlen(request), 0); char answer[4096]; ssize_t got; while ((got = recv(fd, answer, sizeof(answer) - 1, 0)) > 0) { answer[got] = '\0'; fputs(answer, stdout); } close(fd); freeaddrinfo(res); return 0; }

gcc -std=c17 -Wall -Wextra rest.c -o rest

Запрос GET:

./rest GET /index.txt

HTTP/1.0 200 OK Server: SimpleHTTP/0.6 Python/3.14.10 Date: Wed, 18 Nov 2026 07:02:26 GMT Content-type: text/plain Content-Length: 27 Last-Modified: Wed, 18 Nov 2026 07:02:15 GMT hello from the test server

Ответ пришёл целиком: строка состояния, заголовки, пустая строка и тело. Программа печатает его как есть, потому что разбирать JSON — отдельная задача, а на этом шаге важно, что запрос дошёл и что сервер ответил.

Код ответа

Успех или отказ виден в первой строке ответа. Достать число можно sscanf:

int status = 0; if (sscanf(answer, "HTTP/%*d.%*d %d", &status) == 1) { printf("status: %d\n", status); }

status: 404

Запрос несуществующего файла даёт ту же строку состояния с другим числом:

./rest GET /nope.txt

HTTP/1.0 404 File not found Server: SimpleHTTP/0.6 Python/3.14.10 Date: Wed, 18 Nov 2026 07:02:58 GMT Connection: close Content-Type: text/html;charset=utf-8 Content-Length: 460

POST

Метод — это первое слово строки запроса. У POST появляется тело, поэтому нужны Content-Length с длиной тела в байтах и Content-Type с его типом; токен доступа идёт обычным заголовком. Тело можно собрать в том же snprintf:

snprintf(request, sizeof(request), "POST /rules HTTP/1.1\r\n" "Host: 127.0.0.1:8001\r\n" "Authorization: Bearer a-proper-token-goes-here\r\n" "Content-Type: application/json\r\n" "Content-Length: %zu\r\n" "Connection: close\r\n" "\r\n" "%s", strlen(body), body);

./rest POST /rules '{"name":"rule1"}'

HTTP/1.0 201 Created Server: BaseHTTP/0.6 Python/3.14.10 Date: Wed, 18 Nov 2026 07:02:51 GMT Content-Type: application/json Content-Length: 29 {"created": {"name":"rule1"}}

PUT

PUT заменяет объект целиком, поэтому в пути есть его идентификатор, а тело — полный объект, а не набор изменений:

./rest PUT /rules/r_id '{"name":"rule2"}'

HTTP/1.0 200 OK Server: BaseHTTP/0.6 Python/3.14.10 Date: Wed, 18 Nov 2026 07:02:51 GMT Content-Type: application/json Content-Length: 30 {"replaced": {"name":"rule2"}}

DELETE

У DELETE тела нет: ресурс назван путём, а доступ подтверждает токен.

./rest DELETE /rules/r_id

HTTP/1.0 204 No Content Server: BaseHTTP/0.6 Python/3.14.10 Date: Wed, 18 Nov 2026 07:02:51 GMT Content-Type: application/json Content-Length: 0

Код 204 означает, что всё получилось и тела в ответе не будет. Неизвестный метод сервер отвергает кодом 501, и это тоже ответ сервера, а не ошибка программы:

./rest PATCH /x

HTTP/1.0 501 Unsupported method ('PATCH')

Чего нет в чистом Си

Сокет даёт только байты. Всё остальное приходится делать самому или брать библиотеку:

  1. TLS. По https:// нужен рукопожатие и шифрование; в Си без библиотеки этого нет. OpenSSL даёт TLS поверх сокета, libcurl делает то же вместе с HTTP.
  2. Разбор ответа. Заголовки, chunked и Content-Length — это уже HTTP-клиент; здесь ответ просто печатается.
  3. JSON. Тело — строка; чтобы достать поле, нужен разборщик (например, cJSON), а не strstr.
  4. Повторные запросы. Соединение здесь одно и закрывается после ответа (Connection: close). Для сотни запросов нужен пул соединений или библиотека.

Поэтому в рабочем коде на Си берут libcurl: он делает и http, и https, и разбор ответа, и повторные запросы. Сокеты остаются для случая, когда библиотеку подключить нельзя, а сервис свой и отвечает по http.

Все команды и ответы на этой странице получены с gcc 15.2.0 и Python 3.14.10 на Alpine Linux 3.24.3 (x86_64) в контейнере Docker; сервер работал на 127.0.0.1, интернет не использовался.

Автор статьи: Arthur Isaev

Изображение баннера