ZLink HTTP Client For .NET — User Guide

Zlink.HttpClient is a general-purpose HTTP client package for sending HTTP requests from .NET. It is used with a zlink-style fluent builder, and the public surface does not expose System.Net.Http handler types.

using Zlink.HttpClient;

var game = await ZLinkHttpClient.Create("https://game-api.example.internal")
    .Post("/games")
    .Body(new CreateGameReq("ranked-match-0611"))
    .Fetch<CreateGameRes>();

Table Of Contents

Chapter	Document	Content
1	Overview	Design philosophy, deliverable boundary, execution model
2	Getting Started	Project reference, first request, one-line request
3	Client Configuration	Builder options, client reuse, native handler mapping
4	Making Requests	HTTP methods, query parameters, headers, request timeout
5	Request Body	JSON DTO, raw, form, multipart, streaming upload
6	Handling Responses	Response structure, Async, status handling
7	Async	Async, callback, I/O worker and Spot turn rules
8	Streaming	DownloadAsync(sink) download, chunked upload
9	Authentication And TLS	Basic/Bearer, HTTPS verification, mTLS
10	Redirect · Retry · Cookie	Redirect semantics, retry policy, cookie jar
11	Proxy	HTTP proxy, proxy authentication
12	Compression	Transparent gzip/deflate decoding
13	Error Handling	Error kind mapping, retriable, exception paths

Quick Guide

• If this is your first time → 2. Getting Started
• If you're calling this inside a server handler → check 7. Async's blocking rule first
• How failures are reported → 13. Error Handling

The formal contract and regression test axes are owned by the spec document dotnet-http-client.ko.md. This guide covers usage.