콘텐츠로 이동

ZLink HTTP Client For C++ — 사용자 가이드

⚠️ 이 가이드는 최신이 아니다. 현재 리뷰·정비가 끝난 가이드는 .NET 가이드 하나뿐이다. 이 문서는 그 이전 상태이며, .NET 가이드가 완성되면 이 문서를 삭제하고 그것을 기준으로 다시 쓴다.

계약을 확인할 때는 이 문서를 믿지 말고 spec 트리를 본다.

zlink::http_client는 C++에서 HTTP request를 보내기 위한 범용 HTTP client다. zlink 스타일 fluent builder로 사용하며 public header는 Boost.Beast/Asio/OpenSSL 타입을 노출하지 않는다.

#include <zlink/http_client.hpp>

auto game = zlink::http_client::client_t::create ("https://game-api.example.internal")
              .post ("/games")
              .body (create_game_http_req_t{.game_name = "ranked-match-0611"})
              .fetch<create_game_http_res_t> ();

목차

장 문서 내용
1 개요 설계 철학, 산출물 경계, 실행 모델
2 시작하기 CMake 연동, 첫 요청, 한 줄 요청
3 Client 구성 builder 옵션, client 재사용, connection pool
4 Request 만들기 HTTP 메서드, query 파라미터, 헤더, request timeout
5 Request Body JSON DTO, raw, form, multipart, streaming 업로드
6 Response 다루기 result/봉투 구조, submit/fetch, status 처리
7 비동기와 코루틴 task_t, co_await, 콜백, blocking 규칙
8 Streaming download(sink) 다운로드, chunked 업로드
9 인증과 TLS Basic/Bearer, HTTPS 검증, mTLS
10 Redirect · Retry · Cookie redirect 의미론, 재시도 정책, cookie jar
11 Proxy HTTP proxy, CONNECT tunnel, proxy 인증
12 압축 gzip/deflate 투명 해제
13 에러 처리 error kind 매핑, retriable, 예외 경로

빠른 길잡이

정식 계약과 회귀 테스트 축은 spec 문서 cpp-http-client.ko.md가 정본이다. 이 가이드는 사용법을 다룬다.