Запросы к 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')
Чего нет в чистом Си
Сокет даёт только байты. Всё остальное приходится делать самому или брать библиотеку:
- TLS. По https:// нужен рукопожатие и шифрование; в Си без библиотеки этого нет. OpenSSL даёт TLS поверх сокета, libcurl делает то же вместе с HTTP.
- Разбор ответа. Заголовки, chunked и Content-Length — это уже HTTP-клиент; здесь ответ просто печатается.
- JSON. Тело — строка; чтобы достать поле, нужен разборщик (например, cJSON), а не strstr.
- Повторные запросы. Соединение здесь одно и закрывается после ответа (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