apiEntwickler

Ein Ort für jede HostiGuard-API

Preise abrufen, Domains prüfen und registrieren, dedizierte Server bestellen, SMS senden und WHMCS oder WordPress verbinden — jede Integration ist hier dokumentiert, die Downloads finden Sie ganz unten.

Basis-URL https://hostiguard.com/api/v1

Übersicht

HostiGuard bietet eine kleine, vorhersehbare JSON-API. Alle Anfragen laufen über HTTPS, Schlüssel werden als Bearer-Token gesendet, und jede Antwort enthält ein success-Flag. Wählen Sie die benötigte Integration:

Authentifizierung

Erstellen Sie einen Schlüssel unter Dashboard → Business → API. Senden Sie ihn mit jeder Anfrage im Authorization-Header. Der Schlüssel wird beim Erstellen nur einmal angezeigt; bewahren Sie ihn sicher auf und verwenden Sie ihn nie im browserseitigen Code.

Authorization: Bearer hg_live_4cf37e433aaf7c69fed5c47ce11bdb870753bb9a

Jeder Schlüssel hat Berechtigungen. Eine Anfrage an einen Endpunkt, dessen Berechtigung der Schlüssel nicht hat, liefert 403.

lockaccount lockdomains lockservers lockclients

Reseller-Schlüssel & Testmodus

Ein aktiver Reseller (Dashboard → Reseller → API) erhält zwei Schlüssel für dieselbe API. Reseller-Schlüssel haben die Berechtigungen account, domains und servers; die Endpunkte für Unterkunden sind nur für Business-Konten. Preise, die an einen Reseller-Schlüssel geliefert werden, enthalten bereits den Reseller-Tarif — der öffentliche Preis wird zusätzlich als „retail“ angegeben.

hg_live_…

Live-Schlüssel — echte Preise zu Ihrem Reseller-Tarif und echte Bestellungen, bezahlt aus Ihrem Guthaben.

hg_test_…

Test-Schlüssel — identische Abfragen, aber jede Bestellung wird simuliert: Die Anfrage wird geprüft und bepreist, nichts wird erstellt und nichts berechnet. Nutzen Sie ihn, um Ihre Integration sicher aufzubauen und zu testen.

Jede Antwort auf einen Reseller-Schlüssel enthält „mode“ („live“ oder „test“). Eine simulierte Bestellung antwortet mit 200 (nicht 201) und „simulated“: true und sagt Ihnen, ob derselbe Aufruf mit Ihrem Live-Schlüssel erfolgreich wäre:

{
    "success": true,
    "data": {
        "mode": "test",
        "simulated": true,
        "service_type": 3,
        "retail": 12.99,
        "discount": 2.6,
        "reseller_discount": 20,
        "amount": 10.39,
        "currency": "USD",
        "balance": 250
    }
}

Schlüssel werden beim Erstellen einmal angezeigt; das Neuerzeugen eines Schlüssels widerruft den vorherigen sofort. Bewahren Sie den Live-Schlüssel nur auf Ihrem Server auf — niemals im browserseitigen Code.

keyReseller-Schlüssel erhalten

Antwortformat

Jede Antwort hat ein „success“-Flag. Erfolgreiche Aufrufe liefern das Ergebnis in „data“; fehlgeschlagene Aufrufe liefern ein „error“-Objekt mit einem maschinenlesbaren „code“ und einer verständlichen „message“.

{
    "success": true,
    "data": {
        "…": "…"
    }
}
{
    "success": false,
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient wallet balance.",
        "required": 169.99,
        "balance": 65.06
    }
}

Fehlercodes

401 Fehlender, ungültiger oder widerrufener Schlüssel
402 Das Guthaben ist niedriger als die Bestellsumme („required“ und „balance“ sind enthalten)
403 Business-Konto nicht aktiv oder dem Schlüssel fehlt die Berechtigung
404 Ressource nicht gefunden (Bestellung, Unterkunde, Endung)
405 Falsche HTTP-Methode
422 Ungültiger oder fehlender Parameter

Zahlungen

account_balance_wallet

Über die API aufgegebene Bestellungen werden sofort aus dem Guthaben des Kontos bezahlt. Reicht das Guthaben nicht aus, wird die Bestellung nicht erstellt und die API antwortet mit 402. Laden Sie Guthaben unter Dashboard → Guthaben auf. Alle Zahlungen sind endgültig — siehe Rückerstattungsrichtlinie. Rückerstattungsrichtlinie

Business-/Reseller-API v1 — Endpunkte

Business-Schlüssel nutzen die Bereiche (Scopes) des Schlüssels; Reseller-Schlüssel (live / test) können die Endpunkte für Konto, Domains und Server zum Reseller-Preis nutzen. Jeder Endpunkt ist unten mit Parametern, einem cURL-Beispiel und der Antwort aufgeführt.

Endpunkte

GET /account lockBerechtigung: account

Konto

Liefert das Konto, das Unternehmen, das Guthaben und die Berechtigungen des verwendeten Schlüssels.

Beispiel

curl https://hostiguard.com/api/v1/account -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "account_id": 1024,
        "name": "Alpha Web Agency",
        "company": "Alpha Web Agency",
        "account_type": "company",
        "balance": 250,
        "currency": "USD",
        "min_balance": 100,
        "key": {
            "name": "My website",
            "prefix": "hg_live_4cf37e43",
            "scopes": [
                "account",
                "domains"
            ]
        }
    }
}
GET /domains/pricing lockBerechtigung: domains

Domainpreise

Preisliste aller Endungen (Registrierung, Verlängerung, Transfer, Wiederherstellung — pro Jahr). Filtern Sie eine Endung mit tld.

Parameter

tld optional Endung ohne Punkt, z. B. com

Beispiel

curl "https://hostiguard.com/api/v1/domains/pricing?tld=com" -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "tld": ".com",
                "registration": 14.95,
                "renewal": 14.89,
                "transfer": 14.59,
                "restore": 103.9,
                "currency": "USD",
                "per": "year",
                "popular": true
            }
        ]
    }
}
GET /domains/check lockBerechtigung: domains

Domain prüfen

Verfügbarkeit eines Domainnamens mit seinem Preis. „available“ ist true, false oder null, wenn die Registry nicht erreichbar war (später erneut versuchen).

Parameter

domain erforderlich vollständiger Domainname, z. B. mysite.com

Beispiel

curl "https://hostiguard.com/api/v1/domains/check?domain=mysite.com" -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "domain": "mysite.com",
        "available": true,
        "status": "available",
        "price": {
            "registration": 14.95,
            "renewal": 14.89,
            "currency": "USD",
            "per": "year"
        }
    }
}
GET /domains lockBerechtigung: domains

Domains auflisten

Alle Domainnamen des Kontos mit Status, Ablaufdatum und dem zugeordneten Unterkunden.

Beispiel

curl https://hostiguard.com/api/v1/domains -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "domain_id": 46,
                "domain": "mysite.com",
                "status": "active",
                "auto_renew": true,
                "registered": "2026-09-22 00:00:00",
                "expires": "2027-09-21 00:00:00",
                "client_id": 12
            }
        ]
    }
}
POST /domains/register lockBerechtigung: domains

Domain registrieren

Registriert die Domain für die angegebene Anzahl von Jahren und bezahlt sie aus dem Guthaben. Ordnet sie optional einem Unterkunden zu.

Parameter

domain erforderlich vollständiger Domainname, z. B. mysite.com
years optional Registrierungszeitraum in Jahren, 1–10 (Standard 1)
privacy optional true, um WHOIS-Datenschutz zu aktivieren, wo die Endung es erlaubt
nameservers optional Liste der Nameserver, die nach der Registrierung gesetzt werden
client_id optional ID des Unterkunden, dem der Dienst zugeordnet wird

Beispiel

curl -X POST https://hostiguard.com/api/v1/domains/register \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mysite.com","years":1,"privacy":true,"client_id":12}'

Antwort

{
    "success": true,
    "data": {
        "payment_id": 114,
        "order_id": 158,
        "invoice_id": 181,
        "invoice_number": "INV-2026-0072",
        "service_id": 46,
        "service_type": 3,
        "status": 1,
        "client_id": 12,
        "amount": 14.95,
        "currency": "USD",
        "balance": 235.05
    }
}
GET /servers/plans lockBerechtigung: servers

Tarife für dedizierte Server

Verfügbare Tarife für dedizierte Server mit ihren Merkmalen und Preisen pro Abrechnungszeitraum.

Beispiel

curl https://hostiguard.com/api/v1/servers/plans -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "count": 3,
        "items": [
            {
                "plan_id": 2,
                "name": "Performance Dedicated",
                "slug": "performance-dedicated",
                "description": "High-traffic applications",
                "features": [
                    {
                        "text": "16-Core CPU (E5-2680)",
                        "type": "check"
                    }
                ],
                "pricing": {
                    "monthly": {
                        "price": 169.99,
                        "setup_fee": 0
                    },
                    "yearly": {
                        "price": 1799.88,
                        "setup_fee": 0
                    }
                },
                "currency": "USD"
            }
        ]
    }
}
GET /servers lockBerechtigung: servers

Server auflisten

Alle dedizierten Server des Kontos mit Status, IP, Daten und zugeordnetem Unterkunden.

Beispiel

curl https://hostiguard.com/api/v1/servers -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "server_id": 1,
                "plan_id": 2,
                "plan": "Performance Dedicated",
                "hostname": "srv1.example.com",
                "ip_address": "203.0.113.10",
                "status": "active",
                "billing_cycle": "monthly",
                "date_start": "2026-09-22",
                "date_expires": "2026-10-21",
                "client_id": 12
            }
        ]
    }
}
POST /servers/order lockBerechtigung: servers

Dedizierten Server bestellen

Bestellt einen Tarif für den angegebenen Abrechnungszeitraum und bezahlt ihn aus dem Guthaben. Der Server wird dann wie eine Website-Bestellung bereitgestellt.

Parameter

plan_id erforderlich plan_id aus /servers/plans
billing_cycle erforderlich monthly, quarterly, semiannual oder yearly (nur in der Tarifpreisliste aufgeführte Zeiträume)
hostname optional Hostname für den Server
client_id optional ID des Unterkunden, dem der Dienst zugeordnet wird

Beispiel

curl -X POST https://hostiguard.com/api/v1/servers/order \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"plan_id":2,"billing_cycle":"monthly","hostname":"srv1.example.com","client_id":12}'

Antwort

{
    "success": true,
    "data": {
        "payment_id": 115,
        "order_id": 159,
        "invoice_id": 182,
        "invoice_number": "INV-2026-0073",
        "service_id": 1,
        "service_type": 5,
        "status": 1,
        "client_id": 12,
        "amount": 169.99,
        "currency": "USD",
        "balance": 65.06
    }
}
GET /orders/{id} lockBerechtigung: account

Bestelldetails

Status, Artikel und Rechnungen einer Bestellung.

Beispiel

curl https://hostiguard.com/api/v1/orders/158 -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "order_id": 158,
        "status": "complete",
        "total": 89.99,
        "currency": "USD",
        "created_at": "2026-09-22 04:00:19",
        "items": [
            {
                "item_id": 211,
                "service_type": "dedicated",
                "service_id": 1,
                "price": 89.99,
                "setup_fee": 0,
                "next_due": "2026-10-21",
                "status": 1
            }
        ],
        "invoices": [
            {
                "invoice_id": 181,
                "number": "INV-2026-0072",
                "total": 89.99,
                "status": 1,
                "date_paid": "2026-09-22 04:00:19"
            }
        ]
    }
}
GET /clients lockBerechtigung: clients

Unterkunden auflisten

Unterkunden des Kontos mit der Anzahl der jeweils zugeordneten Dienste.

Beispiel

curl https://hostiguard.com/api/v1/clients -H "Authorization: Bearer hg_live_…"

Antwort

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "client_id": 12,
                "account_id": 201,
                "full_name": "Mohammed Al-Rashid",
                "company": "Rashid Trading LLC",
                "email": "[email protected]",
                "phone": "+971500000001",
                "status": "active",
                "services": 3,
                "created_at": "2026-09-22 03:58:15"
            }
        ]
    }
}
POST /clients lockBerechtigung: clients

Unterkunden anlegen

Legt einen Unterkunden mit eigenem HostiGuard-Login an; das Passwort wird an die angegebene Adresse gemailt. Verwenden Sie seine client_id bei Bestellungen.

Parameter

full_name erforderlich Name der Person oder des Unternehmens
company optional Firmenname
email erforderlich E-Mail-Adresse
phone optional Telefonnummer
notes optional interne Notizen

Beispiel

curl -X POST https://hostiguard.com/api/v1/clients \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Ibrahim Saleh","email":"[email protected]"}'

Antwort

{
    "success": true,
    "data": {
        "client_id": 13,
        "account_id": 205,
        "full_name": "Ibrahim Saleh",
        "company": null,
        "email": "[email protected]",
        "phone": null,
        "status": "active",
        "services": 0,
        "created_at": "2026-09-22 04:00:02"
    }
}

SMS-API

Senden Sie Textnachrichten programmatisch über einen aktiven SMS-Dienst. Jede Nachricht wird vom Paketvolumen des mit dem Schlüssel verknüpften Dienstes abgezogen.

Erstellen Sie einen Schlüssel unter Dashboard → SMS → API-Schlüssel und senden Sie ihn im Authorization-Header. Wurde für den Schlüssel ein Secret gesetzt, senden Sie es im Body als api_secret.

Authorization: Bearer sk_your_sms_key
POST https://hostiguard.com/api/sms/send

Parameter

toerforderlichZielnummer im internationalen Format (+1234567890).
messageerforderlichText der Nachricht.
api_secretoptionalNur erforderlich, wenn der Schlüssel ein Secret hat.

Beispiel

curl -X POST https://hostiguard.com/api/sms/send \
  -H "Authorization: Bearer sk_your_sms_key" \
  -H "Content-Type: application/json" \
  -d '{"to":"+1234567890","message":"Hello from HostiGuard!","api_secret":"your_secret"}'

Antwort

{
    "success": true,
    "message": "SMS sent successfully.",
    "data": {
        "to": "+1234567890",
        "message_id": "msg_8f7b0d2c91aa41c3"
    }
}

Fehlercodes

401Fehlender / ungültiger Schlüssel oder falsches api_secret
400"to" oder "message" fehlt
402Kein SMS-Volumen mehr im Paket
403Der SMS-Dienst ist inaktiv oder gesperrt

Schlüssel und Secrets werden verwaltet unter Dashboard → SMS

Zahlungs-Webhooks (eingehend)

Dies sind die URLs, auf denen HostiGuard lauscht. Fügen Sie die richtige im Dashboard jedes Gateways ein, damit Zahlungen bestätigt und Rechnungen ohne manuellen Schritt als bezahlt markiert werden. Signaturen werden mit dem Secret geprüft, das unter Admin → Einstellungen → Zahlungen & APIs gespeichert ist.

GatewayWebhook-URLVerarbeitete Ereignisse
Stripe POST https://hostiguard.com/api/webhooks/stripe checkout.session.completed · payment_intent.payment_failed · charge.refunded
PayPal POST https://hostiguard.com/api/webhooks/paypal CHECKOUT.ORDER.APPROVED · PAYMENT.CAPTURE.COMPLETED · PAYMENT.CAPTURE.DENIED / DECLINED
Paddle POST https://hostiguard.com/api/webhooks/paddle transaction.completed · transaction.paid
Airwallex POST https://hostiguard.com/api/webhooks/airwallex payment_intent.succeeded · payment_intent.requires_capture · payment_intent.captured
Amazon Pay POST https://hostiguard.com/api/webhooks/amazonpay Checkout session / charge notifications (checkoutSessionId or chargeId)
Network (N-Genius) POST / GET https://hostiguard.com/api/webhooks/network TRANSACTION_STATE_CHANGED (state CAPTURED / AUTHORISED)

Ein Webhook wird mit HTTP 200 bestätigt, auch wenn das Ereignis ignoriert wird; fehlgeschlagene Signaturprüfungen liefern 400/401 und werden protokolliert.

WHMCS-Module

v1.0.0 · WHMCS 7.10+ / 8.x

Zwei Module in einem Archiv: ein Domain-Registrar-Modul und ein Provisioning-Modul für dedizierte Server. Beide sprechen mit API v1 über Ihren Business- oder Reseller-Schlüssel; Bestellungen werden zu Ihrem Reseller-Preis aus Ihrem HostiGuard-Guthaben bezahlt.

Was es tut

  • check_circleDomain-Verfügbarkeitssuche pro TLD und Import der TLD-Preise in WHMCS.
  • check_circleDomainregistrierung mit Laufzeit, ID-Schutz und Nameservern; Synchronisierung von Informationen und Ablaufdatum.
  • check_circleProdukte für dedizierte Server: Tarifliste wird live geladen, Bestellung bei „Create“, HostiGuard-IDs werden am Dienst gespeichert.
  • check_circleKundenbereich und Admin-Tab zeigen Hostname, IP, Status und Ablauf direkt von HostiGuard.
  • check_circleEin Reseller-Testschlüssel (hg_test_…) simuliert jede Bestellung — ideal für ein Staging-WHMCS.

Installation

  1. Laden Sie das Archiv unten herunter und entpacken Sie es im Stammverzeichnis Ihres WHMCS (es fügt modules/registrars/hostiguard und modules/servers/hostiguardservers hinzu).
  2. Setup → Products/Services → Domain Registrars → HostiGuard → Activate; geben Sie Ihre HostiGuard-URL und Ihren API-Schlüssel ein.
  3. Optional: Setup → Domain Pricing → Import TLD pricing, um die Preise von HostiGuard zu übernehmen.
  4. Setup → Servers → Add New Server: Modul HostiGuard Dedicated Servers, Hostname = Ihre HostiGuard-URL, SSL an, Access Hash = API-Schlüssel; legen Sie eine Servergruppe an.
  5. Produkt → Module Settings: Wählen Sie den HostiGuard-Tarif und den Abrechnungszeitraum. Protokolle: Utilities → Logs → Module Log.
Gut zu wissen: Verlängerungen, Transfers, Nameserver-Änderungen, EPP-Codes und Sperren / Beenden werden von API v1 noch nicht bereitgestellt — diese Aktionen erfolgen im HostiGuard-Dashboard, und die Module weisen darauf hin, statt stillschweigend zu scheitern.
extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 Dateien · v1.0.0

downloadHerunterladen

WordPress-Plugin — HostiGuard Connector

v1.0.0 · WordPress 5.8+ · PHP 7.4+

Verkaufen Sie HostiGuard-Domains und dedizierte Server von Ihrer eigenen WordPress-Website. Funktioniert ohne WooCommerce (Besucher werden zu HostiGuard geschickt, um die Bestellung abzuschließen) oder mit WooCommerce (Sie werden in Ihrem Shop bezahlt, das Plugin stellt nach der Zahlung bei HostiGuard bereit).

Was es tut

  • check_circle[hostiguard_domain_search] — Live-Verfügbarkeit und -Preis, mit alternativen Endungen.
  • check_circle[hostiguard_domain_pricing] und [hostiguard_server_plans] — Tabellen und Karten aus der API, zwischengespeichert.
  • check_circleWooCommerce: Eine Domain wird zum Live-Preis in den Warenkorb gelegt; nach der Zahlung wird sie über Ihren Schlüssel registriert.
  • check_circleOrdnen Sie jedes WooCommerce-Produkt einem HostiGuard-Servertarif zu (Produktdaten → Tab HostiGuard); er wird bestellt, sobald bezahlt ist.
  • check_circleErgebnisse und Fehler in den Bestellnotizen, erneuter Versuch über Bestellaktionen, die Einstellungsseite zeigt Verbindung und Guthaben.

Installation

  1. Laden Sie die ZIP-Datei unten herunter; WordPress → Plugins → Installieren → Plugin hochladen → Aktivieren.
  2. Einstellungen → HostiGuard: Geben Sie Ihre HostiGuard-URL und Ihren API-Schlüssel ein. Die Seite bestätigt die Verbindung und zeigt Ihr Guthaben und den Schlüsselmodus.
  3. Setzen Sie [hostiguard_domain_search] (und die anderen Shortcodes) auf eine beliebige Seite.
  4. WooCommerce (optional): Legen Sie ein einfaches Produkt „Domainregistrierung“ an, wählen Sie es in den Einstellungen und stellen Sie Registrieren auf den WooCommerce-Modus.
  5. Um Server zu verkaufen: Produkt bearbeiten → Produktdaten → HostiGuard → Tarif und Zeitraum wählen.

Shortcodes

[hostiguard_domain_search]Domainsuche mit Live-Preis. Attribute: tlds="com,net,org", placeholder, button.
[hostiguard_domain_pricing]Preistabelle pro Endung. Attribute: tlds zur Einschränkung, columns="registration,renewal,transfer".
[hostiguard_server_plans]Tarifkarten für dedizierte Server. Attribute: cycle, button, link.
Gut zu wissen: Das Plugin stellt bei HostiGuard erst bereit, wenn die Bestellung bezahlt ist; halten Sie Ihr Guthaben über den erwarteten Bestellungen. Verlängerungen werden bei Ablauf über Ihr HostiGuard-Konto abgerechnet.

Downloads

Beide Pakete werden aus genau dem Code gebaut, der mit dieser HostiGuard-Version ausgeliefert wird, und passen daher immer zur oben dokumentierten API.

extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 Dateien · v1.0.0

downloadHerunterladen
widgets

WordPress plugin (HostiGuard Connector)

hostiguard-connector-1.0.0.zip · 20 KB · 9 Dateien · v1.0.0

downloadHerunterladen
Versionierung: Die Module folgen der API. Sobald sich ein Endpunkt ändert oder ein neuer hinzukommt, werden die WHMCS-Module und das WordPress-Plugin aktualisiert und hier mit neuer Versionsnummer neu veröffentlicht — laden Sie sie nach einem API-Update erneut herunter.

Änderungsprotokoll

  • new_releasesv1.0.0 — Erste Veröffentlichung der vereinheitlichten Dokumentation, der WHMCS-Registrar- und Provisioning-Module und des WordPress-Connector-Plugins (API v1).
HostiGuard

Ihr nächstes Kapitel beginnt hier.

Bringen Sie Ihr Unternehmen mit Hosting voran, das mitwächst.

speedNVMe-SSD-Speicher lockKostenloses SSL verified_user14 Tage Geld-zurück support_agentSupport rund um die Uhr
workspace_premiumPartner & Auszeichnungen

Prüfen Sie uns auf unabhängigen Plattformen

Ein Webhosting-Verzeichnis, Bewertungen echter Kunden und eine von Dun & Bradstreet verifizierte Unternehmensidentität. Alles öffentlich, alles unabhängig von uns.

Partner & Auszeichnungen ansehenarrow_forward