API: HTTP-Anfragen

Funktionen zum Senden von HTTP-Anfragen an externe Dienste und APIs.

C++-Registrierung: regWeb(js). Implementierung: jsWeb.h + NetCurl.h (Wrapper für libcurl).

---

http_get

http_get(url: string) → object

Führt eine HTTP-GET-Anfrage aus.

Parameter:

Parameter	Typ	Beschreibung
url	string	Vollständige URL inkl. Protokoll (https://...)

Ergebnis:

Feld	Typ	Beschreibung
status	number	HTTP-Antwortcode (200, 404, 500, etc.)
body	string	Antwortinhalt (Body)
error	string	curl-Fehlermeldung oder ""

Beispiel:

let r = http_get("https://api.example.com/health");

if (r.error) {
    console.log("Anfragefehler:", r.error);
} else if (r.status !== 200) {
    console.log("HTTP-Fehler:", r.status);
} else {
    let data = JSON.parse(r.body);
    console.log("Antwort:", JSON.stringify(data));
}

---

http_post

http_post(url: string, body: string, headers?: string[]) → object

Führt eine HTTP-POST-Anfrage aus.

Parameter:

Parameter	Typ	Beschreibung
url	string	Vollständige URL
body	string	Anfrageinhalt (JSON, Formulardaten, etc.)
headers	string[]	(optional) Array von HTTP-Headern

Header-Format:

["Content-Type: application/json", "Authorization: Bearer TOKEN"]

Ergebnis:

Feld	Typ	Beschreibung
status	number	HTTP-Antwortcode
body	string	Antwortinhalt (Body)
error	string	Fehlermeldung oder ""

Beispiele:

// JSON senden
let payload = JSON.stringify({ event: "alert", level: "critical" });
let r = http_post(
    "https://api.example.com/events",
    payload,
    ["Content-Type: application/json"]
);
console.log(r.status, r.body);

// Mit Autorisierung
let r2 = http_post(
    "https://api.example.com/data",
    JSON.stringify({ value: 42 }),
    [
        "Content-Type: application/json",
        "Authorization: Bearer my_token_here"
    ]
);

// Ohne Header (z.B. Formulardaten)
let r3 = http_post(
    "https://example.com/form",
    "name=John&age=30"
);

---

Arbeiten mit Webhooks

Discord

let url = "https://discord.com/api/webhooks/ID/TOKEN";
let r = http_post(url, JSON.stringify({
    content: "Alarm! Dienst ist ausgefallen."
}), ["Content-Type: application/json"]);
console.log(r.status);  // 204 = Erfolg

Slack

let url = "https://hooks.slack.com/services/T.../B.../...";
let r = http_post(url, JSON.stringify({
    text: "Alarm! Dienst ist ausgefallen."
}), ["Content-Type: application/json"]);
console.log(r.status);  // 200 = Erfolg

Telegram

let token = "BOT_TOKEN";
let chatId = "CHAT_ID";
let text = encodeURIComponent("Alarm! Dienst ist ausgefallen.");
let r = http_get(
    "https://api.telegram.org/bot" + token +
    "/sendMessage?chat_id=" + chatId + "&text=" + text
);
let resp = JSON.parse(r.body);
console.log(resp.ok);  // true = Erfolg

---

Fehlerbehandlung

function safePost(url, payload, headers) {
    let r = http_post(url, payload, headers);

    // Netzwerkfehler (curl)
    if (r.error) {
        console.log("[ERROR] Netzwerkfehler:", r.error);
        return false;
    }

    // HTTP-Fehler
    if (r.status < 200 || r.status >= 300) {
        console.log("[ERROR] HTTP", r.status, ":", r.body);
        return false;
    }

    return true;
}

---

HTTP-Antwortcodes

Code	Bedeutung
200	OK
201	Created (Erstellt)
204	No Content (Erfolg bei Discord-Webhook)
400	Bad Request (Ungültige Anfrage)
401	Unauthorized (Nicht autorisiert)
403	Forbidden (Verboten)
404	Not Found (Nicht gefunden)
429	Too Many Requests (Rate Limit)
500	Internal Server Error (Interner Serverfehler)