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

Ein gewöhnliches HTTPGet liefert die Antwort so, wie sie kommt — bei 301 oder 302 also die Weiterleitung selbst, nicht das Ziel. Diese Fassung geht den Weg zu Ende.

Seit 1.0.20A liefert HTTPGetHeader nur noch den Wert der gesuchten Zeile (#1452). Vorher kam der Wert plus alle folgenden Kopfzeilen zurück, und gesucht wurde ohne Zeilenanker — ein Type traf damit auch mitten in einem fremden Wert. Ebenfalls neu: headerCount wird tatsächlich gesetzt (#1453); eine Schleife darüber lief bis dahin null Mal.

import std.net.http;

fn main(): int64 {
    var r: HTTPResponse := HTTPGet("example.com" as int64, "/" as int64);
    PrintLn("status        = ", IntToStr(r.statusCode));
    PrintLn("headerCount   = ", IntToStr(r.headerCount));
    PrintLn("contentLength = ", IntToStr(r.contentLength));
    PrintLn("bodySize      = ", IntToStr(r.bodySize));
    PrintLn("Content-Type  = '", HTTPGetHeader(r, "Content-Type" as int64) as pchar, "'");
    return 0;
}

status        = 200
headerCount   = 11
contentLength = 0
bodySize      = 571
Content-Type  = 'text/html'

<WRAP alert> contentLength und bodySize können auseinanderfallen. Im Lauf oben ist contentLength 0, obwohl 571 Byte ankamen — die Gegenstelle hat Transfer-Encoding: chunked benutzt und deshalb gar kein Content-Length geschickt.

Das ist sachlich richtig, am Feldnamen aber nicht zu erkennen. Für die tatsächliche Länge des Rumpfes ist bodySize zuständig, nicht contentLength. Wer über contentLength schleift, verarbeitet bei jeder chunked-Antwort null Bytes. </WRAP>