std.net.http

HTTP/1.1-Client für GET, POST, PUT, DELETE, PATCH und HEAD ohne TLS. Baut auf std.net.socket und std.net.dns auf. Unterstützt Header-Builder (HTTPSetHeader), Bearer- und Basic-Auth (RFC 7617), automatisches Chunked-Transfer-Decoding, 3×x-Redirects (HTTP→HTTP und HTTP→HTTPS, bis 10 Hops) sowie case-insensitives Header-Lesen. Für HTTPS-Verbindungen std.net.https verwenden.

import std.net.http;

var hdrs: int64 := HTTPSetBearerToken(0, "my-token");
var req: HTTPRequest;
req.method  := HTTP_GET;
req.host    := "api.example.com" as int64;
req.path    := "/v1/items" as int64;
req.port    := HTTP_PORT;
req.headers := hdrs;
var resp: HTTPResponse := HTTPSendWithRedirects(req);
if (resp.statusCode = HTTP_OK) {
    PrintLn("OK");
}
HTTPResponseFree(resp);
HTTPHeadersFree(hdrs);

• std.net.socket
• std.net.dns
• std.net.types
• std.string
• std.base64

var hdrs: int64 := HTTPSetBearerToken(0, "eyJhbGci...");
var body: pchar := "{\"status\":\"active\"}";
var resp: HTTPResponse := HTTPPostH(
    "api.example.com" as int64, "/v1/item/42" as int64,
    body as int64, StrLen(body), hdrs);
if (resp.statusCode = HTTP_OK) {
    PrintLn("Aktualisiert");
}
HTTPResponseFree(resp);
HTTPHeadersFree(hdrs);

var resp: HTTPResponse := HTTPGet("api.example.com" as int64, "/" as int64);
var ct: int64 := HTTPGetHeader(resp, "Content-Type" as int64);
if (ct != 0) {
    PrintLn(ct as pchar);
}
HTTPResponseFree(resp);

var req: HTTPRequest;
req.method  := HTTP_GET;
req.host    := "example.com" as int64;
req.path    := "/" as int64;
req.port    := HTTP_PORT;
req.headers := 0;
req.body    := 0;
req.bodySize := 0;
// Folgt automatisch: HTTP 301 → https://example.com/
var resp: HTTPResponse := HTTPSendWithRedirects(req);
HTTPResponseFree(resp);

• Chunked Transfer-Encoding: HTTPSend und alle darauf aufbauenden Funktionen dekodieren Transfer-Encoding: chunked automatisch — kein manuelles Chunk-Parsing nötig.
• Redirects: HTTPSendWithRedirects folgt 3×x-Antworten bis zu HTTP_MAX_REDIRECTS (10) Hops. Ein Wechsel von HTTP auf HTTPS (Location: https://...) wird transparent über TLS abgewickelt.
• HTTPSetHeader ist funktional: Jeder Aufruf gibt einen neuen heap-alloc'd String zurück. Der alte Wert (Eingabe hdrs) wird intern freigegeben — den Rückgabewert immer verwenden, nicht den alten hdrs-Wert weiterverwenden.
• HTTPGetHeader ist case-insensitiv: Content-Type, content-type und CONTENT-TYPE liefern denselben Treffer.
• HTTPResponseFree gibt headersRaw frei: Kein separates Freigeben nötig — ein Aufruf reicht für alle alloc'd Felder der Response.
• Basic Auth (RFC 7617): HTTPSetBasicAuth berechnet base64(user:pass) intern — keine externe Base64-Funktion nötig.
• TLS-Redirects: Für den HTTPS-Hop im Redirect-Pfad muss std.net.tls verfügbar sein.

Letzte Aktualisierung: 2026-06-06