Zum Inhalt springen
+90 850 303 07 52 [email protected]
Support Kundenbereich
Bei ausgewählten Hosting-Paketen mit Jahreslaufzeit und VDS-Paketen mit 3 Monaten Laufzeit: .com / .com.tr-Domain im ersten Jahr kostenlos · Pakete ansehen

API-Dokumentation

Rufen Sie Produkte und Preise ab, bestellen Sie mit Ihrem Guthaben, bezahlen Sie Rechnungen und verwalten Sie Ihre Dienste aus Ihrem eigenen System. Jeder Endpunkt mit Beispielen für curl, PHP, Node.js und Python.

REST + JSON Authentifizierung per Schlüssel Automatische Bestellung per Guthaben

Überblick

Mit der HanHosting API arbeiten unsere Reseller automatisiert aus ihren eigenen Systemen heraus mit uns zusammen: Produkte und Preise abrufen, Bestellungen aufgeben und aus dem Guthaben bezahlen, Rechnungen begleichen sowie Dienste verlängern und verwalten.

Produkte und PreiseAktuelle Pakete, Abrechnungszeiträume, Add-ons und Bestelloptionen.
Automatische BestellungenBerechnen Sie zuerst die Summe, legen Sie dann die Bestellung an und bezahlen Sie sie aus Ihrem Guthaben.
Rechnungen und GuthabenListen Sie offene Rechnungen auf und bezahlen Sie sie aus Ihrem Guthaben; verfolgen Sie Ihre Guthabenbewegungen.
DienstverwaltungVerlängerungen, Kündigungsanträge, Panel-Login, Passwörter und Dienst-Tools.

Basis-URL

Basis-URL
https://hanhosting.com/api/v1/client

Alle Endpunkte liegen unter dieser URL; die Dienstliste ist zum Beispiel GET https://hanhosting.com/api/v1/client/services. Es gibt nur eine Version: v1. Anfragen müssen ausschließlich über HTTPS erfolgen.

Der API-Zugang ist ausschließlich Resellern vorbehalten. Ist die API für Ihr Konto nicht aktiviert, sehen Sie die Seite API Credentials (API-Zugangsdaten) nicht; eröffnen Sie ein Support-Ticket, um den Zugang zu beantragen. In diesem Dokument können Sie die mit Aktiviert gekennzeichneten Endpunkte nutzen; die mit Deaktiviert gekennzeichneten sind für Ihr Konto derzeit nicht aktiviert und liefern 403.

Zugang und API-Schlüssel

Ihren API-Schlüssel erstellen Sie selbst in Ihrem Kundenbereich. Ein Schlüssel hat nur die Berechtigungen, die Sie ihm erteilen, und kann an von Ihnen gewählte IP-Adressen gebunden werden.

Teilen Sie uns zuerst Ihre Server-IP mit. Die API ist nur von Server-IP-Adressen aus erreichbar, die HanHosting freigegeben hat, und der Schlüssel eines Kontos funktioniert nur von den für dieses Konto registrierten IPs aus. Wenn Sie den API-Zugang beantragen, senden Sie uns per Support-Ticket die ausgehende IP-Adresse des Servers, der die API aufrufen wird; ändert sich Ihr Server oder Ihre IP, senden Sie die neue IP vorab. Anfragen von IPs, die nicht auf der Liste stehen, werden mit 403 ip_not_allowed abgewiesen.

  1. Öffnen Sie die Schlüsselseite. Kundenbereich → API Credentials → Create API Key.
  2. Wählen Sie Name und Berechtigungen. Geben Sie dem Schlüssel einen aussagekräftigen Namen (z. B. bayi-otomasyon) und aktivieren Sie nur die Berechtigungen, die Sie benötigen. Die Berechtigungsnamen sind die in diesem Dokument verwendeten Namen im Format Group/Action (z. B. Orders/CreateOrder).
  3. IP-Adressen einschränken (empfohlen). Machen Sie den Schlüssel nur von der IP-Adresse Ihres Servers aus nutzbar. Geben Sie eine IP pro Zeile ein; der Abgleich erfolgt exakt, CIDR-Bereiche (wie /24) werden nicht unterstützt.
  4. Speichern Sie den Schlüssel. Der Schlüssel wird nur einmal angezeigt, nämlich bei seiner Erstellung; bewahren Sie ihn an einem sicheren Ort auf (in einer Umgebungsvariablen oder einem Secrets-Tresor). Wenn Sie ihn verlieren, erhalten Sie mit Regenerate einen neuen geheimen Wert; der alte Wert wird sofort ungültig.

Schlüssel beginnen mit wck_ und sind 36 Zeichen lang. Unser Server speichert nur einen Hash (SHA-256) des Schlüssels, nicht den Schlüssel selbst. Mit Revoke widerrufen Sie einen Schlüssel; einen widerrufenen Schlüssel können Sie löschen. Jede mit einem Schlüssel gestellte Anfrage erscheint maskiert im Tab Request Logs derselben Seite (30 Tage, bis zu 500 Einträge pro Schlüssel).

Halten Sie den Schlüssel geheim. Wer den Schlüssel besitzt, kann im Rahmen der von Ihnen erteilten Berechtigungen im Namen Ihres Kontos bestellen und Zahlungen aus Ihrem Guthaben leisten. Legen Sie den Schlüssel nicht in Code ab, der im Browser läuft, nicht in einer mobilen App und nicht in einem öffentlichen Repository; verwenden Sie ihn nur serverseitig.

Berechtigungsliste

Die Berechtigungen, die Sie beim Erstellen eines Schlüssels auswählen können, und die Endpunkte, die sie freischalten. Jede Berechtigung gilt für genau einen Endpunkt; erteilen Sie keine Berechtigungen, die Ihre Integration nicht nutzt.

BerechtigungEndpunktFunktion
Account/GetMeGET /meIhre Kontoinformationen
Products/GetProductsGET /productsProduktliste
Products/GetProductCategoriesGET /products/categoriesProduktkategorien
Products/GetProductGET /products/{id}Produktdetails und Bestelloptionen
Orders/PreviewOrderPOST /orders/previewBestellsumme berechnen (Vorschau)
Orders/CreateOrderPOST /ordersBestellung anlegen und bezahlen
Orders/GetOrdersGET /ordersBestellliste
Orders/GetOrderGET /orders/{id}Bestelldetails
Invoices/GetInvoicesGET /invoicesRechnungsliste
Invoices/GetInvoiceGET /invoices/{id}Rechnungsdetails
Invoices/PayInvoicePOST /invoices/{id}/payRechnung per Guthaben bezahlen
Balance/GetBalanceGET /balanceGuthaben
Balance/GetBalanceTransactionsGET /balance/transactionsGuthabenbewegungen
Services/GetServicesGET /servicesDienstliste
Services/GetServiceGET /services/{id}Dienstdetails und Zugangsdaten
Services/RenewServicePOST /services/{id}/renewVerlängerungsrechnung erstellen
Services/GetServiceInvoicesGET /services/{id}/invoicesRechnungen eines Dienstes
Services/GetServiceAddonsGET /services/{id}/addonsAdd-ons eines Dienstes
Services/CreateCancellationPOST /services/{id}/cancellationKündigungsantrag stellen
Services/RevokeCancellationDELETE /services/{id}/cancellationKündigungsantrag zurückziehen
Services/GetServiceDashboardGET /services/{id}/dashboardPanel-Übersicht des Dienstes
Services/GetServiceToolsGET /services/{id}/toolsDienst-Tools
Services/GetServiceToolDataGET /services/{id}/tools/{tool}Tool-Daten lesen
Services/RunServiceToolActionPOST /services/{id}/tools/{tool}/{action}Tool-Aktion ausführen
Services/GetServiceSsoPOST /services/{id}/ssoURL für den Panel-Login mit einem Klick
Services/ChangeServicePasswordPOST /services/{id}/passwordPasswort des Dienstes ändern

Für Ihr Konto sind derzeit 26 Berechtigungen aktiviert. Die Endpunkte /ping, /whoami und /reference/* benötigen keine Berechtigung. Endpunkte, die nicht in dieser Liste stehen (Domains, Support-Tickets, SMS, Adressen, Partnerprogramm ...), sind derzeit deaktiviert.

Authentifizierung

Senden Sie den Schlüssel bei jeder Anfrage im Header Authorization als Bearer-Token:

HTTP-Header
Authorization: Bearer wck_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Manche Serverkonfigurationen geben den Header Authorization nicht an die Anwendung weiter. In diesem Fall können Sie denselben Schlüssel im Header X-Api-Key senden.

Verbindung testen

GET /ping erfordert keine Authentifizierung und zeigt, ob Sie die API erreichen. GET /whoami gibt zurück, ob Ihr Schlüssel gültig ist und welche Berechtigungen er hat.

curl -s https://hanhosting.com/api/v1/client/whoami \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"

Anfrage- und Antwortformat

Anfragen

  • Bei GET-Endpunkten senden Sie Filter im Query-String: /services?status=active&page=2.
  • Bei POST / PUT / PATCH / DELETE-Endpunkten senden Sie den Body als JSON und fügen immer Content-Type: application/json hinzu. Ohne diesen Header wird der Body als Formulardaten gelesen; ist der Header vorhanden, wird ungültiges JSON als leerer Body behandelt. Validieren Sie Ihren Body vor dem Senden.
  • Rufen Sie PUT / PATCH / DELETE-Endpunkte nicht direkt mit diesen Methoden auf; solche Anfragen erreichen die API nie (Sie erhalten eine HTML-Seite mit 404). Senden Sie die Anfrage als POST und fügen Sie den Header X-HTTP-Method-Override: DELETE (bzw. PUT, PATCH) hinzu; die Beispiele auf dieser Seite sind so aufgebaut. Der Header wird nur bei POST-Anfragen berücksichtigt.
  • Dateifelder (etwa eine Datei für eine Anforderung) akzeptieren nur base64: reines base64, data:mime;base64,... oder {"filename": "...", "content": "..."}. Eine URL kann nicht angegeben werden.

Erfolgreiche Antwort

Antworten werden als application/json; charset=utf-8 zurückgegeben. Die Daten stehen im Feld data, Listeninformationen im Feld meta. Anfragen, die einen Datensatz anlegen, liefern HTTP 201; andere erfolgreiche Anfragen liefern 200.

Erfolgreiche Antwort
{
  "data": [ { "id": 1204, "name": "HAN-MC-1", "status": "active" } ],
  "meta": { "total": 37, "page": 1, "limit": 25, "next_page": 2 }
}

Fehlerantwort

Fehlerantwort
{
  "error": {
    "code": "insufficient_balance",
    "message": "Your balance is not enough to pay this order.",
    "details": { "required": 540, "available": 120 }
  }
}

Treffen Sie Entscheidungen in Ihrem Programm immer anhand des Feldes error.code; message dient nur zur Information und kann sich ändern. details ist nur vorhanden, wenn es zusätzliche Informationen gibt.

Beträge, Datumsangaben und Abrechnungszeiträume

  • Beträge sind Geldobjekte: {"amount": 180.00, "currency": "TRY"} (2 Nachkommastellen). Produkt-, Bestell- und Vorschaubeträge sind in der Währung Ihres Guthabens angegeben, Dienst- und Rechnungsbeträge in ihrer jeweils eigenen Währung.
  • Die meisten Datumsangaben haben das Format YYYY-MM-DD; Guthabenbewegungen verwenden ISO 8601 (2026-10-01T14:20:00+03:00). Gibt es keinen Wert, wird null zurückgegeben.
  • Schlüssel der Abrechnungszeiträume (cycle): monthly, quarterly, semiannually, annually, biennially, triennially, onetime (sowie hourly, daily, weekly bei stündlich, täglich oder wöchentlich abgerechneten Produkten). pricing in GET /products/{id} zeigt, mit welchen Zeiträumen ein Produkt verkauft wird.

HTTP-Statuscodes und allgemeine Fehlercodes

HTTPCodeBedeutung und Vorgehen
401missing_tokenEs wurde kein Schlüssel gesendet. Fügen Sie Authorization: Bearer ... oder X-Api-Key hinzu.
401invalid_tokenDer Schlüssel wurde nicht erkannt oder ist fehlerhaft. Stellen Sie sicher, dass Sie den vollständigen Schlüssel kopiert haben.
401key_revokedDer Schlüssel wurde widerrufen. Erstellen Sie einen neuen Schlüssel.
401owner_inactiveIhr Konto ist nicht aktiv; wenden Sie sich an den Support.
403ip_not_allowedDie Anfrage kam von einer nicht zugelassenen IP: Ihre IP steht nicht auf der API-Liste von HanHosting oder ist nicht in der IP-Beschränkung Ihres Schlüssels enthalten. Senden Sie die ausgehende IP Ihres Servers per Support-Ticket; wenn Sie für den Schlüssel eine IP-Beschränkung nutzen, tragen Sie die IP auch dort ein.
403account_not_allowedIhr Konto steht nicht auf der Liste der Konten mit API-Zugang. Wenden Sie sich für den API-Zugang an den Support.
403insufficient_scopeDem Schlüssel fehlt die für diesen Endpunkt erforderliche Berechtigung. Die Meldung nennt die fehlende Berechtigung (z. B. Orders/CreateOrder); bearbeiten Sie den Schlüssel und fügen Sie die Berechtigung hinzu. Ist der Endpunkt für Ihr Konto deaktiviert, erscheint er nicht in der Berechtigungsliste.
403client_api_not_allowed, client_scope_revoked, surface_disabledDer API-Zugang ist für Ihr Konto deaktiviert, oder die Berechtigungen Ihres Schlüssels sind für Ihr Konto nicht mehr aktiviert. Wenden Sie sich an den Support.
403audience_mismatchDer Schlüssel wurde nicht für diese API erstellt. Verwenden Sie einen Schlüssel, der auf der Seite API Credentials in Ihrem Kundenbereich erstellt wurde.
400operation_failedDer Vorgang konnte nicht abgeschlossen werden; lesen Sie die Meldung und teilen Sie sie bei Bedarf dem Support mit.
404endpoint_not_found, not_foundDie URL existiert nicht, oder der angeforderte Datensatz (Dienst, Rechnung, Bestellung ...) gehört nicht Ihnen.
405method_not_allowedDie URL ist korrekt, aber die HTTP-Methode ist falsch (z. B. GET statt POST).
409idempotency_in_flightDie vorherige Anfrage mit demselben Idempotency-Key wird noch verarbeitet; wiederholen Sie sie in Kürze mit demselben Schlüssel.
413payload_too_largeDer Body ist zu groß (meist wegen großer base64-Dateien).
422idempotency_key_invalid, idempotency_key_reuseIdempotency-Key ist nicht 8–191 Zeichen lang, oder derselbe Schlüssel wurde mit einem anderen Body verwendet. Siehe Idempotente Anfragen.
422validation_failed und endpunktspezifische CodesDie Anfrage ist formal korrekt, verstößt aber gegen eine Geschäftsregel (fehlendes Feld, unzureichendes Guthaben, ungültiger Zeitraum ...). Die Codes sind in der Beschreibung des jeweiligen Endpunkts aufgeführt.
429rate_limitedDas Anfragelimit pro Minute wurde überschritten. Warten Sie die in Retry-After angegebene Zeit ab.
429abuse_lockout, too_many_auth_failuresVorübergehende Sperre (15 Minuten) wegen übermäßiger Last oder zu vieler fehlgeschlagener Authentifizierungsversuche.
500server_error und endpunktspezifische CodesEin unerwarteter Fehler, oder das verbundene Panel (Server, Lizenz usw.) hat die Anfrage abgelehnt. Protokollieren Sie die Meldung; hilft eine Wiederholung nicht, teilen Sie sie dem Support mit.

Rate-Limits und Schutzmechanismen

  • Das Standardlimit pro Schlüssel beträgt 60 Anfragen pro Minute; das aktuelle Limit Ihres Schlüssels steht im Header X-RateLimit-Limit. Das Minutenfenster ist fest; der Zähler wird zu Beginn jeder neuen Minute zurückgesetzt.
  • Jede authentifizierte Antwort enthält Header mit Ihrem verbleibenden Kontingent (bei /ping und bei Authentifizierungsfehlern werden sie nicht gesendet): X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (Ende des Fensters als Unix-Zeitstempel). Bei einer 429-Antwort gibt Retry-After an, wie viele Sekunden Sie warten müssen.
  • Ein Schlüssel, der innerhalb einer Minute mehr als das 5-Fache seines Limits sendet, wird für 15 Minuten gesperrt (abuse_lockout).
  • Viele fehlgeschlagene Schlüsselversuche von derselben IP innerhalb von 5 Minuten sperren diese IP für 15 Minuten (too_many_auth_failures).
  • Auch abgelehnte Anfragen zählen zum Limit. Statt die Dienstliste häufig komplett abzufragen, rufen Sie gezielt die Datensätze ab, die sich ändern, und cachen Sie die Ergebnisse kurzzeitig.

Paginierung, Suche und Sortierung

  • Listen-Endpunkte akzeptieren page (beginnt bei 1) und limit (1–100, Standard 25).
  • Das Objekt meta in der Antwort: total (Gesamtzahl der Datensätze), page, limit, next_page (auf der letzten Seite 0).
  • search durchsucht je nach Endpunkt Felder wie Name, Domain oder Rechnungsnummer.
  • Die Reihenfolge der Listen ist fest (wichtige Datensätze zuerst); nur die Rechnungsliste lässt sich sortieren, und zwar mit sort und dir.
PHP · alle Seiten durchlaufen
$page = 1;
do {
    $r = hh_api('GET', '/services?limit=100&page=' . $page);
    foreach ($r['data'] as $hizmet) {
        // ...
    }
    $page = $r['meta']['next_page'];
} while ($page > 0);

Idempotente Anfragen (Idempotency-Key)

Bricht die Netzwerkverbindung ab, wissen Sie unter Umständen nicht, ob eine Bestellanfrage angekommen ist. Fügen Sie den Header Idempotency-Key zu POST-Anfragen hinzu, die Geld bewegen (POST /orders, POST /invoices/{id}/pay, POST /services/{id}/renew); eine mit demselben Schlüssel wiederholte Anfrage wird kein zweites Mal verarbeitet, und die ursprüngliche Antwort wird unverändert zurückgegeben.

  • Der Header wird nur bei POST-Anfragen berücksichtigt. Der Schlüssel ist 8–191 Zeichen lang (andernfalls 422 idempotency_key_invalid); erzeugen Sie für jeden neuen Vorgang einen eindeutigen Wert (z. B. Ihre eigene Bestellnummer oder eine UUID).
  • Die Antwort wird 24 Stunden lang gespeichert. Eine wiederholt ausgelieferte Antwort enthält den Header Idempotency-Replayed: true.
  • Verwenden Sie denselben Schlüssel mit einem anderen Body, erhalten Sie 422 idempotency_key_reuse; der Body muss Byte für Byte identisch sein.
  • Wird die erste Anfrage noch verarbeitet, wird 409 idempotency_in_flight zurückgegeben; warten Sie einen Moment und versuchen Sie es mit demselben Schlüssel erneut. Eine hängende Vorgangssperre wird nach 10 Minuten aufgehoben.

Auch Fehlerantworten werden gespeichert. Hat die erste Anfrage einen 4xx-Fehler geliefert (zum Beispiel 422 insufficient_balance), liefern Wiederholungen mit demselben Schlüssel 24 Stunden lang denselben Fehler. Senden Sie die Anfrage nach Behebung des Problems (etwa nach dem Aufladen Ihres Guthabens) mit einem neuen Schlüssel. Nur ein 500 server_error gibt den Schlüssel wieder frei.

HTTP-Header
Idempotency-Key: bayi-siparis-2026-000184

Szenario: automatische Bestellung mit Ihrem Guthaben

Der empfohlene Ablauf, um automatisch dasselbe Paket bei uns zu kaufen, wenn Ihr Kunde bei Ihnen ein Paket kauft:

  1. Produkt und Optionen abrufen: GET /products/{id}. pricing zeigt die angebotenen Zeiträume, requirements und addons die Auswahlen, die Sie mit der Bestellung senden müssen, und domain.mode, ob eine Domain benötigt wird.
  2. Guthaben prüfen: GET /balance.
  3. Summe berechnen: POST /orders/preview liefert die Summe einschließlich Gutscheinen und Steuern, ohne eine Bestellung anzulegen.
  4. Bestellung anlegen: POST /orders + "payment": {"method": "balance"} + Idempotency-Key. Reicht Ihr Guthaben aus, wird die Rechnung gleichzeitig bezahlt, und der Dienst gelangt in die Bereitstellungswarteschlange.
  5. Bereitstellung verfolgen: Entnehmen Sie die Dienst-ID aus services[] in GET /orders/{id}; sobald GET /services/{id} den Status active zeigt, geben Sie die Zugangsdaten (access) an Ihren Kunden weiter.
PHP · durchgängiges Beispiel
$urun = hh_api('GET', '/products/176')['data'];          // HAN-MC-1
$istek = [
    'terms'   => true,
    'items'   => [[
        'product_id'   => 176,
        'cycle'        => 'monthly',
        // Selections such as Installation Type (Game Panel / VDS): IDs come from GET /products/{id} → requirements[].options[]
        'requirements' => ['3' => '0'],
    ]],
    'payment' => ['method' => 'balance'],
];

$onizleme = hh_api('POST', '/orders/preview', $istek)['data'];
$bakiye   = hh_api('GET', '/balance')['data']['balance'];
if ($bakiye['amount'] < $onizleme['total']['amount']) {
    exit('Insufficient balance: ' . $onizleme['total']['amount'] . ' ' . $onizleme['total']['currency']);
}

$siparis = hh_api('POST', '/orders', $istek, ['Idempotency-Key: bayi-siparis-' . $benimSiparisNo])['data'];
if ($siparis['payment']['status'] !== 'paid') {
    // The order and invoice were created but could not be paid: top up your balance and pay with POST /invoices/{id}/pay.
}
echo 'Order no: ' . $siparis['number'];

Zahlungsmethode: Zahlungen über die API erfolgen aus Ihrem Kontoguthaben. Laden Sie Ihr Guthaben im Kundenbereich auf (Account Balance → Add Funds). Bestellungen mit einer Summe von 0 erfordern keine Zahlung. Reicht Ihr Guthaben nicht aus, wird die Bestellung gar nicht erst angelegt, und es wird 422 insufficient_balance zurückgegeben.

Szenario: Dienstverlängerung und Rechnungszahlung

  1. GET /services/{id} → die verlängerbaren Zeiträume sehen Sie in renewal.available und renewal.cycles. Hat der Dienst eine offene Rechnung, ist renewal.open_invoice_id gesetzt.
  2. POST /services/{id}/renew (optional {"cycle": "annually"}) → eine Verlängerungsrechnung wird ausgestellt; es erfolgt keine Zahlung. Ist derselbe Zeitraum bereits in Rechnung gestellt, wird die vorhandene Rechnung mit existing: true zurückgegeben.
  3. POST /invoices/{invoice_id}/pay + {"payment": {"method": "balance"}} → die Rechnung wird aus Ihrem Guthaben bezahlt, und die Laufzeit des Dienstes wird verlängert.

Um bald fällige Dienste zu finden, verwenden Sie das Feld due_date im Ergebnis von GET /services?status=active. Für unbezahlte Rechnungen stellen Sie zwei Abfragen: GET /invoices?status=unpaid (noch nicht fällig) und GET /invoices?status=overdue (überfällig).

Szenario: Dienstverwaltung (Panel-Login, Passwort, Tools)

  • Panel-Login mit einem Klick: POST /services/{id}/sso liefert eine URL, die direkt im Control Panel des Dienstes anmeldet (cPanel, Game-Panel usw.). Die URL ist kurzlebig; leiten Sie den Kunden sofort weiter und speichern Sie sie nicht.
  • Passwortänderung: POST /services/{id}/password (Hosting- und Serverdienste).
  • Übersicht und Ressourcennutzung: GET /services/{id}/dashboard liefert den Panel-Namen, die verfügbaren Aktionen und die Ressourcenanzeigen.
  • Dienst-Tools: GET /services/{id}/tools listet die für Ihren Dienst verfügbaren Tools und die Aktionen jedes Tools auf (capabilities). Verwenden Sie GET /services/{id}/tools/{tool} zum Lesen von Daten und POST /services/{id}/tools/{tool}/{action} zum Ausführen von Vorgängen. Die Tools hängen vom Panel ab, mit dem der Dienst verbunden ist; beim Webhosting gibt es zum Beispiel Tools für E-Mail-Konten, Datenbanken, DNS-Einträge und Cronjobs.
curl · E-Mail-Konto auf dem Hosting anlegen
curl -s -X POST https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts/create \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "info", "domain": "ornekfirma.com", "password": "Guclu-Parola-2026!"}'

Tool-Aktionen nehmen echte Änderungen im Panel vor und werden im Dienstverlauf protokolliert. Vorgänge, die das Panel ablehnt, liefern HTTP 500 tool_action_failed mit der Meldung des Panels.

Szenario: VNC-Konsole auf VDS-Servern

Bei VDS-Diensten (virtuelle Server) erreichen Sie den Bildschirm der Maschine über die VNC-Konsole, auch wenn die Netzwerkverbindung oder RDP/SSH nicht funktioniert. Sie läuft auf derselben Infrastruktur wie die Console in unserem Kundenbereich; mit der URL, die Sie von der API erhalten, können Sie sie in Ihr eigenes Panel einbinden. Die Nutzung ist optional und für Reseller gedacht, die sie benötigen.

  1. Zustand der Maschine abrufen: GET /services/{id}/tools/vnc-console. Das Feld power liefert running, stopped, installing oder suspended. Ist die Maschine ausgeschaltet, starten Sie sie zuerst mit POST /services/{id}/tools/start-server/execute; läuft gerade eine Installation, warten Sie, bis sie abgeschlossen ist.
  2. Verbindungs-URL abrufen: POST /services/{id}/tools/vnc-console/create (kein Body erforderlich). Das Feld data.url in der Antwort ist eine einmalig nutzbare URL der Form wss://console.hanhosting.com/…/beconsole/….
  3. Verbinden: Übergeben Sie die URL sofort, innerhalb von 3 Minuten, an einen VNC-Client (RFB), zum Beispiel noVNC im Browser. Die URL kann nur einmal verwendet werden; rufen Sie für jede neue Verbindung eine neue URL ab.
curl · Verbindungs-URL abrufen
curl -s -X POST https://hanhosting.com/api/v1/client/services/1204/tools/vnc-console/create \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort · HTTP 200
{ "data": { "status": "successful", "url": "wss://console.hanhosting.com/4/beconsole/…" } }
JavaScript · Anzeige im Browser mit noVNC
// The API key never reaches the browser: your own server gets the URL from the API and gives the browser only the wss URL.
import RFB from './novnc/core/rfb.js';   // core/rfb.js from the noVNC source

const yanit = await fetch('/panelim/vnc-adresi?hizmet=1204', { method: 'POST' });
const { url } = await yanit.json();

const rfb = new RFB(document.getElementById('ekran'), url);
rfb.scaleViewport = true;
rfb.addEventListener('disconnect', (e) => console.log('Connection closed', e.detail.clean));

// On Windows, lock the session when you leave (Win+L); otherwise the console session stays open.
function oturumuKilitle() {
    rfb.sendKey(0xffeb, 'MetaLeft', true);
    rfb.sendKey(0x006c, 'KeyL');
    rfb.sendKey(0xffeb, 'MetaLeft', false);
}

Limits und Fehlerfälle

  • Die Konsole lässt sich nur bei aktiven Diensten öffnen.
  • Pro Dienst müssen zwischen zwei URLs mindestens 3 Sekunden liegen, und es können höchstens 15 pro 10 Minuten abgerufen werden. Wird dies überschritten, wird 500 tool_action_failed mit der Meldung „Too many console requests were sent in a short time…“ zurückgegeben.
  • Kann keine URL abgerufen werden (zum Beispiel, weil die Maschine ausgeschaltet ist), wird 500 tool_action_failed mit der Meldung „Could not get a console connection…“ zurückgegeben; starten Sie die Maschine und versuchen Sie es erneut.
  • Der Endpunkt für die Konsolenverbindung akzeptiert 30 Anfragen pro Minute und IP. Zusätzlich gilt das eigene Limit Ihres API-Schlüssels (60 Anfragen pro Minute).
  • Wird die Konsole von einer IP-Adresse geöffnet, die in den letzten 30 Tagen nicht verwendet wurde, wird eine Benachrichtigungs-E-Mail an Ihr Konto gesendet. Beim Öffnen über die API ist diese IP die Adresse Ihres Servers, der die Anfrage stellt.

Tastaturlayout: Das Feld kbd_default zeigt das Layout, das die Maschine erwartet: tr (türkisches Q) bei Windows-Vorlagen, us bei den übrigen. Die Konsole sendet Tasten nach dem US-Layout; wenn Sie von Ihrem eigenen Client aus auf einer Windows-Maschine mit türkischem Q tippen, kann zum Beispiel die Taste i als ı ankommen – achten Sie daher besonders bei der Passworteingabe darauf. Die Konsole in unserem Kundenbereich nimmt diese Umwandlung selbst vor.

RDP-Sitzungen sind auf dem VNC-Bildschirm nicht sichtbar; die Konsole zeigt den eigenen Bildschirm der Maschine.

Endpunkt-Referenz

Von insgesamt 112 Endpunkten können Sie 31 nutzen. Klicken Sie auf einen Endpunkt, um seine Parameter, Beispiele für curl / PHP / Node.js / Python, eine Beispielantwort und mögliche Fehler einzublenden.

IDs, Preise und Datumsangaben in den Beispielen dienen nur zur Veranschaulichung; aktuelle Werte erhalten Sie über die jeweiligen Endpunkte. Die PHP-Beispiele verwenden die Hilfsfunktion hh_api() aus dem Abschnitt Authentifizierung.

Keine Endpunkte entsprechen Ihrer Suche.

System und Referenzdaten

Verbindungstest, Schlüsselinformationen sowie die Länder-, Provinz- und Bezirkslisten für Adressformulare. Diese Endpunkte benötigen keine gesonderte Berechtigung; alle außer /ping erfordern einen gültigen Schlüssel. 5 / 5 aktiviert

GET/pingVerbindungstest Keine Berechtigung erforderlich

Kein Schlüssel erforderlich. Zeigt, ob Sie die API erreichen können. 120 Anfragen pro Minute und IP.

Berechtigung: nicht erforderlichGET https://hanhosting.com/api/v1/client/ping
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/ping" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": { "pong": true, "version": "v1", "time": "2026-10-01 14:20:00" } }
GET/whoamiSchlüsselinformationen Keine Berechtigung erforderlich

Kann mit jedem gültigen Schlüssel aufgerufen werden (keine gesonderte Berechtigung erforderlich). Liefert den Namen des Schlüssels, seine Berechtigungen und den Zeitpunkt seiner vorherigen Nutzung.

Berechtigung: nicht erforderlichGET https://hanhosting.com/api/v1/client/whoami
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/whoami" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "id": 12,
    "type": "client",
    "name": "bayi-otomasyon",
    "permissions": ["Products/GetProducts", "Orders/PreviewOrder", "Orders/CreateOrder", "Balance/GetBalance"],
    "last_access": "2026-10-01 14:18:02",
    "owner_id": 1001
  }
}
GET/reference/countriesLänderliste Keine Berechtigung erforderlich

Ländercodes (ISO-2) und Ländernamen. Werden in den Feldern für Adress- und Rechnungsdaten verwendet.

Berechtigung: nicht erforderlichGET https://hanhosting.com/api/v1/client/reference/countries
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/reference/countries" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": [ { "code": "TR", "name": "Turkey" }, { "code": "DE", "name": "Germany" } ] }
GET/reference/countries/{code}/statesProvinzen eines Landes Keine Berechtigung erforderlich
Berechtigung: nicht erforderlichGET https://hanhosting.com/api/v1/client/reference/countries/{code}/states
Pfadparameter
FeldTypBeschreibung
codePflichtfeldstringLändercode (ISO-2), z. B. TR
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/reference/countries/TR/states" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": [ { "id": 34, "name": "Istanbul" }, { "id": 6, "name": "Ankara" } ] }
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundLändercode nicht gefunden.
GET/reference/states/{id}/citiesBezirke einer Provinz Keine Berechtigung erforderlich
Berechtigung: nicht erforderlichGET https://hanhosting.com/api/v1/client/reference/states/{id}/cities
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerProvinz-ID (aus der Antwort von GetStates)
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/reference/states/34/cities" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": [ { "id": 1103, "name": "Kadikoy" }, { "id": 1104, "name": "Uskudar" } ] }
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundProvinz nicht gefunden.

Produkte

Verfügbare Produkte, Kategorien, Preise je Abrechnungszeitraum und Bestelloptionen. 3 / 3 aktiviert

GET/productsProduktliste Aktiviert

Verfügbare Produkte (aktiv und sichtbar), Bestandsstatus und Preise je Abrechnungszeitraum. Die Preise sind in der Währung Ihres Guthabens angegeben.

Berechtigung: Products/GetProductsGET https://hanhosting.com/api/v1/client/products
Query-Parameter
FeldTypBeschreibung
typestringProdukttyp: hosting, server, software, special ... Ein ungültiger Typ liefert 422 type_invalid zusammen mit den zulässigen Typen.
categoryintegerKategorie-ID (GetProductCategories).
searchstringDurchsucht die Produktnamen.
page, limitintegerPaginierung (limit 1–100, Standard 25).
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/products?category=35" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    {
      "id": 176,
      "type": "server",
      "title": "HAN-MC-1",
      "tagline": "",
      "category": { "id": 35, "name": "Minecraft Server" },
      "in_stock": true,
      "stock": null,
      "pricing": [
        { "cycle": "monthly",   "price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "promo": false },
        { "cycle": "quarterly", "price": { "amount": 540.00, "currency": "TRY" }, "setup": null, "promo": false },
        { "cycle": "annually",  "price": { "amount": 2160.00, "currency": "TRY" }, "setup": null, "promo": false }
      ]
    }
  ],
  "meta": { "total": 9, "page": 1, "limit": 25, "next_page": 0, "currency": "TRY" }
}
GET/products/categoriesProduktkategorien Aktiviert
Berechtigung: Products/GetProductCategoriesGET https://hanhosting.com/api/v1/client/products/categories
Query-Parameter
FeldTypBeschreibung
typestringNur Kategorien dieses Typs.
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/products/categories" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "id": 34, "parent": null, "type": "server", "name": "Game Servers" },
    { "id": 35, "parent": 34, "type": "server", "name": "Minecraft Server" }
  ],
  "meta": { "total": 2 }
}
GET/products/{id}Produktdetails und Bestelloptionen Aktiviert

Rufen Sie diese Angaben vor einer Bestellung immer ab: die angebotenen Abrechnungszeiträume (pricing), Add-ons (addons), die bei der Bestellung abgefragten Auswahlen (requirements), die Mengenregel und ob eine Domain benötigt wird (domain).

Berechtigung: Products/GetProductGET https://hanhosting.com/api/v1/client/products/{id}
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerProdukt-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/products/176" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "id": 176,
    "type": "server",
    "title": "HAN-MC-1",
    "tagline": "",
    "description": "…",
    "category": { "id": 35, "name": "Minecraft Server" },
    "in_stock": true,
    "stock": null,
    "quantity": { "allowed": false, "mode": 0 },
    "order_limit_per_user": null,
    "pricing": [ { "cycle": "monthly", "price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "promo": false } ],
    "addons": [
      {
        "id": 11, "name": "EXTRA RAM", "description": "", "field_type": "select", "required": false,
        "options": [ { "id": 0, "name": "2 GB", "cycle": "monthly", "price": { "amount": 60.00, "currency": "TRY" } } ],
        "requirements": []
      }
    ],
    "requirements": [
      { "id": 3, "name": "Installation Type", "field_type": "radio", "required": false,
        "options": [ { "id": "0", "name": "Game Panel (Web Panel)" }, { "id": "1", "name": "VDS Server" } ] },
      { "id": 5, "name": "Operating System", "field_type": "radio", "required": false,
        "options": [ { "id": "0", "name": "26.04 LTS" }, { "id": "1", "name": "24.04 LTS" } ] }
    ],
    "metrics": [],
    "domain": { "mode": "none" }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDas Produkt ist nicht im Verkauf, ist ausgeblendet oder existiert nicht.

requirements / addons: Bei der Bestellung senden Sie {"<requirement id>": "<option id>"} im Feld requirements und {"<addon id>": <option id>} im Feld addons. Das Feld price einer Add-on-Option kann bei kostenlosen Optionen null sein. Senden Sie in Ihrer API-Bestellung auch die Auswahlen mit, die auf der Bestellseite unserer Website mit einem Sternchen (*) gekennzeichnet sind.

domain.mode: none bedeutet, dass keine Domain benötigt wird; chooser erfordert domain in der Bestellposition (eigene Domain oder Subdomain); license erfordert eine Lizenz-Domain bzw. -IP. Neue Domain-Registrierungen erfolgen über die Domain-Endpunkte, nicht über diesen Endpunkt.

Bestellungen

Preisvorschau, Bestellung per Guthaben und Bestellübersicht. 4 / 4 aktiviert

POST/orders/previewBestellsumme berechnen (Vorschau) Aktiviert

Berechnet die Gesamtsumme einschließlich des anteiligen ersten Zeitraums, der Add-ons, der Einrichtungsgebühr, der Gutscheine und der Steuern, ohne eine Bestellung anzulegen. Es werden keine Datensätze erstellt, und Ihr Guthaben bleibt unberührt.

Berechtigung: Orders/PreviewOrderPOST https://hanhosting.com/api/v1/client/orders/preview
Body-Felder (JSON)
FeldTypBeschreibung
itemsPflichtfeldarrayBestellpositionen; gleiche Struktur wie bei POST /orders.
couponsarrayGutscheincodes.
billing_profile_idintegerGespeicherte Rechnungsadresse (bestimmt den Steuersatz).
paymentobject{"method": "balance"}; dient nur dazu, die Gebühr der Zahlungsmethode (fee) in die Berechnung einzubeziehen.
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/orders/preview" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "items": [
    { "product_id": 176, "cycle": "monthly", "requirements": { "3": "0" } }
  ]
}'
Beispielantwort
HTTP 200
{
  "data": {
    "items": [
      { "kind": "product", "product_id": 176, "name": "HAN-MC-1", "cycle": "monthly", "quantity": 1,
        "domain": null, "unit_price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "total": { "amount": 180.00, "currency": "TRY" } }
    ],
    "subtotal": { "amount": 180.00, "currency": "TRY" },
    "discount": { "amount": 0.00, "currency": "TRY" },
    "tax": { "amount": 36.00, "currency": "TRY" },
    "fee": null,
    "total": { "amount": 216.00, "currency": "TRY" }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422…Fehler zu einzelnen Positionen (Produkt, Zeitraum, Anforderung, Add-on, Domain, Gutschein) sind dieselben wie bei POST /orders.

unit_price ist der Preis für den vollen Zeitraum; total enthält den anteiligen Betrag für den ersten Zeitraum, die Add-ons und die Einrichtungsgebühr. Die Vorschau prüft die Annahme der Vertragsbedingungen, Kontobeschränkungen und Ihr Guthaben nicht; diese werden erst bei POST /orders geprüft.

POST/ordersBestellung anlegen und bezahlen Aktiviert

Legt die Bestellung, die zugehörige Rechnung und die Dienstdatensätze an und bezahlt die Rechnung anschließend aus Ihrem Guthaben. Nach Abschluss der Zahlung gelangt der Dienst in die Warteschlange der automatischen Bereitstellung.

Berechtigung: Orders/CreateOrderPOST https://hanhosting.com/api/v1/client/orders Idempotency-Key empfohlen
Body-Felder (JSON)
FeldTypBeschreibung
termsPflichtfeldbooleanAnnahme des Dienstleistungsvertrags: muss als JSON-Wert true gesendet werden, andernfalls 422 terms_required.
itemsPflichtfeldarrayBis zu 20 Positionen. Die Felder einer Position sind unten aufgeführt.
items[].product_idPflichtfeldintegerProdukt-ID (muss im Verkauf sein).
items[].cyclePflichtfeldstringSchlüssel des Abrechnungszeitraums; einer der Werte aus der Liste pricing des Produkts.
items[].quantityintegerStandard 1. Wenn das Produkt keine Mengenauswahl erlaubt, wird 1 angenommen.
items[].requirementsobjectBestellauswahl: {"3": "1", "5": "1"}. Eine Options-ID bei Auswahlfeldern, ein Array von IDs bei Checkboxen, Text bei Textfeldern.
items[].requirement_filesobjectAnforderungen, die eine Datei verlangen: {"<id>": "base64 or data-URI"}.
items[].addonsobjectAdd-ons: {"11": 0} (Add-on-ID → Options-ID). Für ein Add-on, das Sie gar nicht möchten, senden Sie den Schlüssel nicht mit.
items[].addons_qtyobjectMenge bei Add-ons, die nach Menge verkauft werden: {"11": 2}.
items[].metricsarrayMetrik-IDs zum Aktivieren nutzungsbasiert abgerechneter Metriken.
items[].domainobjectBei Produkten mit domain.mode=chooser: {"option": "owned", "name": "ornekfirma.com"} oder {"option": "subdomain", "base": "…", "name": "etiket"}. Bei Lizenzprodukten: {"license_domain": "…"} oder {"license_ip": "…"}.
paymentPflichtfeldobject{"method": "balance"}. Nicht erforderlich, wenn die Summe 0 beträgt.
couponsarrayGutscheincodes.
billing_profile_idintegerGespeicherte Rechnungsadresse; ohne Angabe wird die Kontoadresse verwendet.
notesstringBestellnotiz (bis zu 1000 Zeichen).
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/orders" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bayi-islem-000184" \
  -d '{
  "terms": true,
  "items": [
    {
      "product_id": 176,
      "cycle": "monthly",
      "requirements": { "3": "1", "5": "1" },
      "addons": { "11": 0 }
    }
  ],
  "payment": { "method": "balance" },
  "notes": "Reseller customer #184"
}'
Beispielantwort
HTTP 201
{
  "data": {
    "order_id": 3120,
    "number": "3120",
    "status": "waiting",
    "total": { "amount": 288.00, "currency": "TRY" },
    "payment": { "method": "balance", "status": "paid" },
    "invoice": {
      "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid",
      "total": { "amount": 288.00, "currency": "TRY" }, "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01"
    }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422terms_requiredterms wurde nicht als true gesendet.
422items_required, items_invalid, too_many_itemsKeine Positionen, eine fehlerhafte Liste oder mehr als 20 Positionen.
422item_invalid, product_requiredEine Position ist kein Objekt, oder product_id fehlt.
422product_not_orderableDas Produkt ist nicht im Verkauf.
422cycle_invalidDieses Produkt bietet den Zeitraum nicht an; details.allowed listet die gültigen Zeiträume auf.
422item_unpricedFür diesen Zeitraum ist kein Preis festgelegt.
422out_of_stock, order_limit_reachedNicht vorrätig, oder das Bestelllimit für das Produkt ist erreicht.
422addon_invalid, addon_option_invalidDas Add-on gehört nicht zu diesem Produkt, oder die Option existiert nicht.
422requirement_missingEine erforderliche Auswahl wurde nicht gesendet.
422file_url_not_allowed, file_upload_failedFür ein Dateifeld wurde eine URL angegeben, oder die base64-Datei konnte nicht gespeichert werden.
422metric_invalidDie Metrik gehört nicht zu diesem Produkt.
422domain_required, domain_invalid, subdomain_invalid, subdomain_base_invalidDie Domain-Auswahl fehlt oder ist ungültig.
422license_domain_required, license_ip_requiredFür ein Lizenzprodukt wurde keine Domain bzw. IP gesendet.
422domain_acquisition_not_hereNeue Domain-Registrierungen und -Transfers sind mit diesem Endpunkt nicht möglich.
422coupon_invalidDer Gutschein ist ungültig oder kann auf diese Bestellung nicht angewendet werden.
422payment_method_invalid, payment_method_unavailableDie Zahlungsmethode fehlt, ist ungültig oder nicht verfügbar. Senden Sie balance.
422insufficient_balanceGuthaben nicht ausreichend; die Bestellung wird nicht angelegt. details.required und details.available (Zahlen) werden zurückgegeben.
422account_restricted, checkout_blockedIhr Konto ist für Bestellungen gesperrt.
404not_foundDie in billing_profile_id angegebene Rechnungsadresse wurde nicht gefunden.

Nebeneffekte: Bestellung, Rechnung und Dienstdatensätze werden angelegt; reicht Ihr Guthaben aus, erhält die Rechnung sofort den Status paid, und die Bereitstellung beginnt. Ist payment.status gleich failed (der Grund steht im Feld payment.error), bleiben Bestellung und Rechnung bestehen; Sie können Ihr Guthaben aufladen und mit POST /invoices/{id}/pay bezahlen. Bei einer Bestellung mit einer Summe von 0 liefert das Feld payment den Wert {"method": "free", "status": "paid"}.

Gameserver-Pakete: Für diese Pakete ist die Auswahl Installation Type (Installationsart) erforderlich: Game Panel oder VDS Server. Wenn Sie VDS wählen, senden Sie zusätzlich die Auswahl Operating System (Betriebssystem); VDS-Zusatzdienste (zusätzlicher RAM, CPU, Speicherplatz, IP, DDoS-Schutz) gelten nur für eine VDS-Installation. IDs wie "3", "5", "11" in den Beispielen dienen nur zur Veranschaulichung; lesen Sie die tatsächlichen IDs für Anforderungen, Optionen und Add-ons immer aus der Antwort von GET /products/{id}.

GET/ordersBestellliste Aktiviert

Ihre Bestellungen, die neuesten zuerst.

Berechtigung: Orders/GetOrdersGET https://hanhosting.com/api/v1/client/orders
Query-Parameter
FeldTypBeschreibung
page, limitintegerPaginierung.
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/orders" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "id": 3120, "number": "3120", "status": "active", "total": { "amount": 288.00, "currency": "TRY" }, "payment_method": "Balance",
      "invoice_id": 5871, "items_count": 1, "created_at": "2026-10-01" }
  ],
  "meta": { "total": 14, "page": 1, "limit": 25, "next_page": 0 }
}
GET/orders/{id}Bestelldetails Aktiviert

Bestellpositionen, die durch die Bestellung angelegten Dienste (services[]) und eine Rechnungsübersicht. Nach der Bestellung entnehmen Sie hier die Dienst-ID.

Berechtigung: Orders/GetOrderGET https://hanhosting.com/api/v1/client/orders/{id}
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerBestell-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/orders/3120" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "id": 3120, "number": "3120", "status": "active", "total": { "amount": 288.00, "currency": "TRY" }, "payment_method": "Balance",
    "invoice_id": 5871, "items_count": 1, "created_at": "2026-10-01",
    "items": [ { "name": "HAN-MC-1", "quantity": 1, "total": { "amount": 288.00, "currency": "TRY" } } ],
    "services": [ { "id": 1204, "name": "HAN-MC-1", "type": "server", "status": "active" } ],
    "invoice": { "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid", "total": { "amount": 288.00, "currency": "TRY" },
                 "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01" },
    "notes": "Reseller customer #184"
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDie Bestellung existiert nicht oder gehört nicht Ihnen.

Rechnungen

Rechnungsliste, Rechnungsdetails und Zahlung per Guthaben. 3 / 4 aktiviert

GET/invoicesRechnungsliste Aktiviert

Standardreihenfolge: überfällig, offen, bezahlt, erstattet, storniert.

Berechtigung: Invoices/GetInvoicesGET https://hanhosting.com/api/v1/client/invoices
Query-Parameter
FeldTypBeschreibung
statusstringpaid, unpaid, overdue, refunded, cancelled, waiting.
searchstringRechnungsnummer oder die Beschreibung der ersten Rechnungsposition.
sortstringcreated, due, price
dirstringasc / desc (Standard: desc)
page, limitintegerPaginierung.
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/invoices?status=overdue" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "invoice_id": 5902, "number": "HAN2026-5902", "status": "unpaid", "state": "overdue", "total": { "amount": 180.00, "currency": "TRY" },
      "created_at": "2026-09-20", "paid_at": null, "due_date": "2026-09-28", "first_item": "HAN-MC-1 (Monthly renewal)" }
  ],
  "meta": { "total": 1, "page": 1, "limit": 25, "next_page": 0 }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422status_invalidUngültiger Statuswert.

status ist der Rohstatus; state kennzeichnet unbezahlte Rechnungen mit überschrittener Fälligkeit als overdue. Hinweis: Der Filter status=unpaid enthält keine überfälligen Rechnungen; um alle unbezahlten Rechnungen zu erhalten, stellen Sie zwei getrennte Abfragen mit unpaid und overdue.

GET/invoices/{id}Rechnungsdetails Aktiviert

Rechnungspositionen, Aufschlüsselung von Steuern und Rabatten, fälliger Betrag (amount_due), ob die Rechnung bezahlt werden kann (payable), Rechnungsdaten und Zahlungstransaktionen.

Berechtigung: Invoices/GetInvoiceGET https://hanhosting.com/api/v1/client/invoices/{id}
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerRechnungs-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/invoices/5902" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "invoice_id": 5902, "number": "HAN2026-5902", "status": "unpaid", "state": "overdue",
    "total": { "amount": 180.00, "currency": "TRY" }, "amount_due": { "amount": 180.00, "currency": "TRY" }, "payable": true,
    "created_at": "2026-09-20", "paid_at": null, "due_date": "2026-09-28",
    "items": [
      { "item_id": 9911, "description": "HAN-MC-1 (Monthly renewal)", "service_id": 1204, "cycle": "monthly",
        "period_start": "2026-10-01", "period_end": "2026-10-31", "quantity": 1,
        "unit_price": { "amount": 150.00, "currency": "TRY" }, "total": { "amount": 150.00, "currency": "TRY" } }
    ],
    "summary": {
      "subtotal": { "amount": 150.00, "currency": "TRY" }, "tax": { "rate": 20, "amount": { "amount": 30.00, "currency": "TRY" } },
      "total": { "amount": 180.00, "currency": "TRY" }, "paid": { "amount": 0.00, "currency": "TRY" }, "amount_due": { "amount": 180.00, "currency": "TRY" }
    },
    "transactions": []
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDie Rechnung existiert nicht oder gehört nicht Ihnen.

Die Antwort enthält außerdem die Felder Rechnungsdaten (billed_to), notes, custom_fields, Angaben zur Banküberweisung (bank_transfer) und subscription_locked; bei den Rechnungspositionen parent_item_id, event, domain, tax_exempt, additional_taxes; sowie discounts (reseller, coupon), payment_fee und installment innerhalb von summary. Bei einer steuerfreien Rechnung ist summary.tax gleich null.

POST/invoices/{id}/payRechnung per Guthaben bezahlen Aktiviert

Bezahlt eine unbezahlte Rechnung aus Ihrem Kontoguthaben. Handelt es sich um eine Verlängerungsrechnung, wird die Laufzeit des Dienstes verlängert.

Berechtigung: Invoices/PayInvoicePOST https://hanhosting.com/api/v1/client/invoices/{id}/pay Idempotency-Key empfohlen
Body-Felder (JSON)
FeldTypBeschreibung
idPflichtfeldintegerRechnungs-ID (im Pfad)
payment.methodPflichtfeldstringbalance
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/invoices/5902/pay" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bayi-islem-000184" \
  -d '{ "payment": { "method": "balance" } }'
Beispielantwort
HTTP 200
{
  "data": {
    "invoice": { "invoice_id": 5902, "number": "HAN2026-5902", "status": "paid", "state": "paid",
                 "total": { "amount": 180.00, "currency": "TRY" }, "amount_due": { "amount": 0.00, "currency": "TRY" }, "paid_at": "2026-10-01" },
    "payment": { "method": "balance", "status": "paid" }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422invoice_not_payableDie Rechnung ist nicht unbezahlt, oder es ist kein Betrag fällig.
422subscription_collectsDiese Rechnung wird über ein Abonnement eingezogen.
422balance_not_allowedEine Rechnung zur Guthabenaufladung kann nicht mit Guthaben bezahlt werden.
422payment_method_invalid, payment_method_unavailableDie Zahlungsmethode fehlt, ist ungültig oder nicht verfügbar. Senden Sie balance.
422payment_rejectedDie Zahlung wurde abgelehnt.
422insufficient_balanceIhr Guthaben deckt den fälligen Betrag (einschließlich etwaiger Gebühren) nicht.
429invoice_payment_in_progressDieselbe Rechnung wird gerade durch eine andere Anfrage bezahlt.
500wallet_charge_failedDie Belastung Ihres Guthabens konnte nicht abgeschlossen werden; versuchen Sie es erneut und wenden Sie sich an den Support, falls das Problem bestehen bleibt.
POST/invoices/{id}/couponGutschein auf eine Rechnung anwenden Deaktiviert

Wendet mit {"code": "KUPON"} einen Rabattgutschein auf eine unbezahlte Rechnung an.

Berechtigung: Invoices/ApplyInvoiceCouponPOST https://hanhosting.com/api/v1/client/invoices/{id}/coupon

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Guthaben

Aktuelles Guthaben und Guthabenbewegungen. 2 / 3 aktiviert

GET/balanceGuthaben Aktiviert

Aktuelles Guthaben, Warnung bei niedrigem Guthaben und Einstellungen für die automatische Zahlung per Guthaben.

Berechtigung: Balance/GetBalanceGET https://hanhosting.com/api/v1/client/balance
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/balance" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "balance": { "amount": 2500.00, "currency": "TRY" },
    "wallet_empty": false,
    "low_balance": false,
    "auto_pay": { "from_balance": true, "available": true, "backup_card": null },
    "alert": { "enabled": true, "threshold": { "amount": 500.00, "currency": "TRY" },
               "recipients": [ { "id": 0, "name": "Name Surname", "email": "[email protected]", "enabled": true, "owner": true } ] }
  }
}
GET/balance/transactionsGuthabenbewegungen Aktiviert
Berechtigung: Balance/GetBalanceTransactionsGET https://hanhosting.com/api/v1/client/balance/transactions
Query-Parameter
FeldTypBeschreibung
typestringup (Aufladung) / down (Ausgabe)
searchstringDurchsucht die Beschreibungen.
page, limitintegerPaginierung.
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/balance/transactions" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "transaction_id": 88213, "type": "down", "amount": { "amount": 288.00, "currency": "TRY" }, "description": "Invoice #HAN2026-5871",
      "invoice_id": 5871, "created_at": "2026-10-01T14:20:05+03:00" }
  ],
  "meta": { "total": 42, "page": 1, "limit": 25, "next_page": 2 }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422type_invalidUngültiger Typ.
PATCH/balance/settingsGuthabeneinstellungen Deaktiviert

Einstellungen für die automatische Zahlung per Guthaben, die Ersatzkarte und die Warnung bei niedrigem Guthaben.

Berechtigung: Balance/UpdateBalanceSettingsPATCH https://hanhosting.com/api/v1/client/balance/settings

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Dienste

Dienstliste und Dienstdetails, Verlängerung, Paket-Upgrades, Reverse DNS (rDNS), Kündigungsanträge, Panel-Login, Passwort und Dienst-Tools. 18 / 23 aktiviert

GET/servicesDienstliste Aktiviert

Alle Ihre Dienste außer Domains. Reihenfolge: überfällige aktive Dienste, ausstehend, gesperrt, aktiv, abgelaufen.

Berechtigung: Services/GetServicesGET https://hanhosting.com/api/v1/client/services
Query-Parameter
FeldTypBeschreibung
statusstringactive, pending, suspended, expired, cancelled
typestringhosting, server, software, special
searchstringDurchsucht den Namen, die Domain oder den Servernamen.
page, limitintegerPaginierung.
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services?status=active" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "id": 1204, "type": "server", "name": "HAN-MC-1", "status": "active", "host": "203.0.113.25:25565",
      "product_id": 176, "auto_renew": true, "price": { "amount": 180.00, "currency": "TRY" }, "cycle": "monthly",
      "created_at": "2026-10-01", "due_date": "2026-11-01" }
  ],
  "meta": { "total": 1, "page": 1, "limit": 25, "next_page": 0 }
}
GET/services/{id}Dienstdetails und Zugangsdaten Aktiviert

Status, Preis und Fälligkeitsdatum, Zugangsdaten (access), Verlängerungsoptionen (renewal) und ein etwaiger Kündigungsantrag (cancellation).

Berechtigung: Services/GetServiceGET https://hanhosting.com/api/v1/client/services/{id}
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "id": 1204, "type": "server", "name": "HAN-MC-1", "status": "active",
    "product": { "id": 176, "name": "HAN-MC-1" }, "host": "203.0.113.25:25565", "order_id": 3120,
    "auto_renew": true, "auto_renew_locked": false, "managed": false, "billing_profile_id": 0,
    "price": { "amount": 180.00, "currency": "TRY" }, "cycle": "monthly",
    "created_at": "2026-10-01", "due_date": "2026-11-01",
    "access": { "ip": "203.0.113.25", "username": "…", "password": "…" },
    "renewal": {
      "available": true, "blocked_by_subscription": false, "already_invoiced": false, "open_invoice_id": 0,
      "cycles": [ { "cycle": "monthly", "price": { "amount": 180.00, "currency": "TRY" }, "save_pct": 0 },
                  { "cycle": "annually", "price": { "amount": 2160.00, "currency": "TRY" }, "save_pct": 0 } ]
    },
    "cancellation": null,
    "has_metrics": false
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDer Dienst existiert nicht, gehört nicht Ihnen, oder der Zugriff darauf ist eingeschränkt.

Je nach Diensttyp kann access folgende Schlüssel enthalten: domain, hostname, ip, assigned_ips, username, password, server, nameservers; bei Lizenzdiensten außerdem license_key und license_parameters. Leere Schlüssel werden vollständig aus der Antwort weggelassen. access.password wird im Klartext zurückgegeben; speichern Sie es sicher. Gibt es keine offene Rechnung, ist renewal.open_invoice_id gleich 0.

POST/services/{id}/renewVerlängerungsrechnung erstellen Aktiviert

Stellt eine Verlängerungsrechnung für den Dienst aus; es erfolgt keine Zahlung. Zum Bezahlen verwenden Sie POST /invoices/{id}/pay.

Berechtigung: Services/RenewServicePOST https://hanhosting.com/api/v1/client/services/{id}/renew Idempotency-Key empfohlen
Body-Felder (JSON)
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID (im Pfad)
cyclestringVerlängerungszeitraum; einer aus renewal.cycles. Ohne Angabe gilt der aktuelle Zeitraum.
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/renew" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bayi-islem-000184" \
  -d '{ "cycle": "annually" }'
Beispielantwort
HTTP 201
{
  "data": {
    "invoice_id": 5933, "number": "HAN2026-5933", "status": "unpaid", "state": "unpaid",
    "total": { "amount": 2160.00, "currency": "TRY" }, "created_at": "2026-10-01", "paid_at": null, "due_date": "2026-11-01",
    "existing": false
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422cycle_invalidDieser Zeitraum wird für die Verlängerung nicht angeboten.
422not_renewableDer Dienst hat nicht den Status aktiv, abgelaufen oder gekündigt.
422already_invoicedDieser Zeitraum wurde bereits in Rechnung gestellt.
422renew_blocked_subscriptionDer Dienst wird über ein Abonnement verlängert.
422renew_disabled, renew_rejectedFür diesen Dienst kann keine Verlängerungsrechnung ausgestellt werden.
422account_restrictedIhr Konto ist für Verlängerungen gesperrt.
500renew_failedDie Rechnung konnte nicht erstellt werden (z. B. bei einem einmaligen Dienst).

Ist derselbe Zeitraum bereits in Rechnung gestellt und hat der Dienst eine offene Rechnung, wird keine neue Rechnung ausgestellt; die vorhandene Rechnung wird mit HTTP 200 und "existing": true zurückgegeben. Eine neue Rechnung liefert HTTP 201.

GET/services/{id}/invoicesRechnungen eines Dienstes Aktiviert
Berechtigung: Services/GetServiceInvoicesGET https://hanhosting.com/api/v1/client/services/{id}/invoices
Query-Parameter
FeldTypBeschreibung
limitinteger1–100, Standard 25
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/invoices" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid", "total": { "amount": 288.00, "currency": "TRY" },
      "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01" }
  ]
}
GET/services/{id}/addonsAdd-ons eines Dienstes Aktiviert

Ausstehende, aktive und gesperrte Zusatzdienste (zusätzlicher RAM, zusätzliche IP usw.).

Berechtigung: Services/GetServiceAddonsGET https://hanhosting.com/api/v1/client/services/{id}/addons
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/addons" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "id": 77, "addon_id": 11, "option_id": 0, "name": "EXTRA RAM", "option": "2 GB", "quantity": 1, "status": "active",
      "price": { "amount": 60.00, "currency": "TRY" }, "cycle": "monthly", "due_date": "2026-11-01", "unpaid_invoice_id": 0,
      "cancellation_requested": false }
  ]
}
GET/services/{id}/upgrade-optionsUpgrade-Optionen Aktiviert

Alle höheren Pakete, auf die der Dienst wechseln kann (gleiche Familie, z. B. HAN-R9-2 … HAN-R9-12 für HAN-R9-1), und der zu zahlende Betrag je Abrechnungszeitraum. difference ist die Preisdifferenz für die verbleibenden Tage; reseller_discount ist Ihr Reseller-Rabatt und payable_total der Betrag inklusive MwSt., der von Ihrem Guthaben abgebucht wird. Zwischenpakete können übersprungen werden.

Berechtigung: Services/GetService (keine gesonderte Berechtigung)GET https://hanhosting.com/api/v1/client/services/{id}/upgrade-options
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade-options" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "service": { "id": 1027, "product_id": 107, "name": "HAN-R9-6", "period": "month", "period_time": 1, "amount": 608.9, "currency": "TRY", "due_date": "2026-11-22 22:46:04" },
    "options": [
      { "product_id": 110, "name": "HAN-R9-8", "category": "Ryzen Premium VDS",
        "features": ["8 vCPU", "16 GB RAM", "200 GB NVMe"],
        "prices": [
          { "price_id": 581, "period": "month", "period_time": 1, "cycle": "Monthly", "amount": 808.9, "difference": 376.78,
            "reseller_discount": { "rate": 30, "amount": 113.03 }, "tax_rate": 0, "payable_total": 263.75, "currency": "TRY" }
        ] }
    ],
    "pending": null,
    "balance": { "available": 1520.4, "currency": "TRY" }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDer Dienst existiert nicht oder gehört nicht Ihnen.
422service_not_activeNur aktive Dienste können ein Upgrade erhalten.
403upgrades_disabledFür diesen Diensttyp sind Upgrades deaktiviert.
403insufficient_scopeDem Schlüssel fehlt die Berechtigung Services/GetService.

Eine leere Liste bedeutet, dass der Dienst bereits das höchste Paket seiner Familie nutzt. Downgrades werden nicht angeboten. Die Beträge hängen von den zum jeweiligen Zeitpunkt verbleibenden Tagen ab; fragen Sie sie unmittelbar vor dem Kauf erneut ab.

POST/services/{id}/upgradePaket upgraden Aktiviert

Stuft den Dienst auf das gewählte höhere Paket hoch: Eine Differenzrechnung wird ausgestellt und aus Ihrem Guthaben bezahlt (mit Reseller-Rabatt), anschließend werden die Ressourcen automatisch erhöht. Der Server startet dabei für 1–2 Minuten neu. dry_run: true liefert den Betrag und ob Ihr Guthaben ihn deckt, ohne etwas anzulegen.

Berechtigung: Services/GetService + Invoices/PayInvoice (keine gesonderte Berechtigung)POST https://hanhosting.com/api/v1/client/services/{id}/upgrade Idempotency-Key empfohlen
Body-Felder (JSON)
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID (im Pfad)
product_idPflichtfeldintegerZielpaket aus der Liste upgrade-options
price_idintegerAbrechnungszeitraum; ohne Angabe der aktuelle Zeitraum des Dienstes (z. B. monthly)
pay_with_balancebooleanStandard true. Mit false bleibt die Rechnung unbezahlt; das Upgrade beginnt, sobald sie mit POST /invoices/{id}/pay bezahlt wurde.
dry_runbooleantrue: nur prüfen und Preis berechnen; es wird weder ein Datensatz noch eine Rechnung angelegt
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/upgrade" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bayi-islem-000184" \
  -d '{ "product_id": 110 }'
Beispielantwort
HTTP 201
{
  "data": {
    "dry_run": false, "service_id": 1027,
    "from_product": { "id": 107, "name": "HAN-R9-6" }, "to_product": { "id": 110, "name": "HAN-R9-8" },
    "price": { "price_id": 581, "period": "month", "period_time": 1, "cycle": "Monthly", "amount": 808.9, "difference": 376.78,
               "reseller_discount": { "rate": 30, "amount": 113.03 }, "tax_rate": 0, "payable_total": 263.75, "currency": "TRY" },
    "pay_with_balance": true, "balance": { "available": 1520.4, "currency": "TRY" },
    "upgrade": { "id": 12, "type": "up", "status": "inprocess", "message": "", "from_product": { "id": 107, "name": "HAN-R9-6" },
                 "to_product": { "id": 110, "name": "HAN-R9-8" }, "invoice_id": 6120, "invoice_status": "paid", "created_at": "2026-11-01 03:10:00" },
    "invoice_id": 6120,
    "payment": { "method": "balance", "status": "paid" }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422product_not_upgradeableDas Paket ist keine Upgrade-Option für diesen Dienst (andere Familie oder niedrigeres Paket).
422price_not_foundprice_id gehört zu keinem der Abrechnungszeiträume dieses Pakets.
422insufficient_balanceIhr Guthaben reicht nicht aus; siehe details.required / details.available.
422payment_failedDie Rechnung konnte nicht aus dem Guthaben bezahlt werden; das Upgrade wurde abgebrochen.
409upgrade_pendingFür den Dienst läuft bereits ein Upgrade; verfolgen Sie es mit GET /services/{id}/upgrade.
403insufficient_scopeDem Schlüssel fehlt die Berechtigung Invoices/PayInvoice.

Wenn die Antwort eintrifft, ist die Zahlung bereits erfolgt; die Ressourcenerhöhung ist innerhalb weniger Minuten abgeschlossen (upgrade.status: inprocess → completed). Wird auf Windows-Servern das Laufwerk C: nicht automatisch erweitert, erweitern Sie es in „Disk Management“ (Datenträgerverwaltung).

GET/services/{id}/upgradeUpgrade-Status Aktiviert

Status des letzten Upgrades des Dienstes: inprocess (läuft), completed, cancelled. Gibt es keines, upgrade: null.

Berechtigung: Services/GetService (keine gesonderte Berechtigung)GET https://hanhosting.com/api/v1/client/services/{id}/upgrade
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "service": { "id": 1027, "product_id": 110, "name": "HAN-R9-8", "period": "month", "period_time": 1, "amount": 808.9, "currency": "TRY", "due_date": "2026-12-01 03:10:00" },
    "upgrade": { "id": 12, "type": "up", "status": "completed", "message": "", "from_product": { "id": 107, "name": "HAN-R9-6" },
                 "to_product": { "id": 110, "name": "HAN-R9-8" }, "invoice_id": 6120, "invoice_status": "paid", "created_at": "2026-11-01 03:10:00" }
  }
}
GET/services/{id}/rdnsReverse-DNS-Einträge (rDNS) Aktiviert

Die IPs des Dienstes, deren Reverse DNS verwaltet werden kann, jeweils mit aktuellem PTR-Namen und Standardnamen. Derzeit können 176.96.128.x-Adressen verwaltet werden. remaining_this_month zeigt die in diesem Monat verbleibenden Änderungen: pro IP in jeder Zeile und als Summe für alle IPs des Dienstes auf oberster Ebene (2 pro IP und Monat).

Berechtigung: Services/GetService (keine gesonderte Berechtigung)GET https://hanhosting.com/api/v1/client/services/{id}/rdns
Pfadparameter
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/rdns" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "service_id": 1058,
    "ips": [
      { "ip": "176.96.128.115", "ptr": "mail.ornekfirma.com", "default": "176-96-128-115.hanhosting.net", "custom": true },
      { "ip": "176.96.128.114", "ptr": "176-96-128-114.hanhosting.net", "default": "176-96-128-114.hanhosting.net", "custom": false }
    ],
    "monthly_limit": 2,
    "remaining_this_month": 1
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDer Dienst existiert nicht oder gehört nicht Ihnen.
503rdns_unavailableDer Reverse-DNS-Dienst antwortet vorübergehend nicht; versuchen Sie es in Kürze erneut.
POST/services/{id}/rdnsReverse DNS (rDNS) festlegen Aktiviert

Legt den PTR-Namen der IP fest oder stellt (wenn hostname leer ist) den Standardnamen wieder her. Der Name muss forward-confirmed sein: Legen Sie zuerst einen A-Record für ihn an, der auf die IP zeigt. Höchstens 2 Änderungen pro IP und Monat; auch das Wiederherstellen des Standardnamens zählt. Ist der Name bereits gesetzt, wird nichts geändert und keine Änderung verbraucht. dry_run: true prüft nur.

Berechtigung: Services/GetService + Services/RunServiceToolAction (keine gesonderte Berechtigung)POST https://hanhosting.com/api/v1/client/services/{id}/rdns
Body-Felder (JSON)
FeldTypBeschreibung
idPflichtfeldintegerDienst-ID (im Pfad)
ipPflichtfeldstringEine IP des Dienstes (aus GET /services/{id}/rdns)
hostnamestringPTR-Name, z. B. mail.ornekfirma.com. Leer oder ohne Angabe wird der Standardname wiederhergestellt.
dry_runbooleantrue: nur prüfen, den Eintrag nicht ändern
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/rdns" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "ip": "176.96.128.115", "hostname": "mail.ornekfirma.com" }'
Beispielantwort
HTTP 200
{ "data": { "ip": "176.96.128.115", "ptr": "mail.ornekfirma.com", "dry_run": false, "unchanged": false, "remaining_this_month": 1 } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
422a_record_missingDer A-Record des Namens zeigt nicht auf diese IP; details.a_records listet die gefundenen Einträge auf.
422invalid_hostnameUngültiger Name (Buchstaben, Ziffern, Bindestrich, Punkt; mindestens zwei Labels).
404ip_not_ownedDie IP gehört nicht zu diesem Dienst.
422ip_not_supportedDer Reverse DNS dieser IP kann hier nicht geändert werden.
429monthly_limitDas Änderungslimit für diese IP ist für diesen Monat erreicht (2 pro IP und Monat).
403insufficient_scopeDem Schlüssel fehlt die Berechtigung Services/RunServiceToolAction.

Die Änderung wird sofort auf den primären und sekundären Nameserver geschrieben; bei öffentlichen DNS-Caches kann es einige Minuten dauern, bis sie sichtbar ist. Wird der Dienst gelöscht oder wechselt die IP zu einem anderen Dienst, wird der eigene Name automatisch auf den Standardnamen zurückgesetzt.

POST/services/{id}/cancellationKündigungsantrag stellen Aktiviert

Stellt einen Kündigungsantrag für einen aktiven Dienst. Unser Team bearbeitet den Antrag; der Dienst wird nicht sofort abgeschaltet.

Berechtigung: Services/CreateCancellationPOST https://hanhosting.com/api/v1/client/services/{id}/cancellation
Body-Felder (JSON)
FeldTypBeschreibung
urgencyPflichtfeldstringnow (sofort) / period-ending (zum Ende des Zeitraums)
reasonPflichtfeldstringnot-needed, too-expensive, switching, missing-features, other
reason_detailstringBis zu 300 Zeichen; erforderlich bei reason=other.
notestringBis zu 500 Zeichen.
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/cancellation" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "urgency": "period-ending", "reason": "not-needed", "note": "The customer closed the project." }'
Beispielantwort
HTTP 201
{
  "data": { "status": "pending", "urgency": "period-ending", "reason": "I no longer need it", "reason_key": "not-needed",
            "note": "The customer closed the project.", "requested_at": "2026-10-01" }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422not_actionableDer Dienst ist nicht aktiv.
422cancellation_existsEs besteht bereits ein offener Kündigungsantrag.
422urgency_invalid, reason_invalid, reason_detail_requiredFeldwerte sind ungültig oder fehlen.
422cancellation_rejectedDer Kündigungsantrag wurde für diesen Dienst nicht angenommen.
500cancellation_failedDer Antrag konnte nicht gespeichert werden; versuchen Sie es erneut.
DELETE/services/{id}/cancellationKündigungsantrag zurückziehen Aktiviert

Entfernt einen ausstehenden oder genehmigten Kündigungsantrag; kein Body erforderlich.

Berechtigung: Services/RevokeCancellationDELETE https://hanhosting.com/api/v1/client/services/{id}/cancellation
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/cancellation" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "X-HTTP-Method-Override: DELETE"
Beispielantwort
HTTP 200
{ "data": { "revoked": true, "service_id": 1204 } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundEs gibt keinen offenen Kündigungsantrag.
GET/services/{id}/dashboardPanel-Übersicht des Dienstes Aktiviert

Name des verbundenen Panels, Unterstützung für Login mit einem Klick und Passwortänderungen, Schnellaktionen und Ressourcenanzeigen (CPU, RAM, Speicherplatz usw.). Der Dienst muss aktiv sein.

Berechtigung: Services/GetServiceDashboardGET https://hanhosting.com/api/v1/client/services/{id}/dashboard
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/dashboard" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "module": "Pterodactyl", "panel_name": "HanHosting Game Panel", "sso_available": true,
    "can_change_password": false, "has_tools": true, "methods": [],
    "quick_actions": [],
    "overview": { "gauges": [ { "key": "ram", "label": "RAM", "used": 1.2, "total": 2, "unit": "GB" } ], "resources": [], "account": [] }
  }
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422not_actionableDer Dienst ist nicht aktiv.
422module_unavailableDas mit dem Dienst verbundene Panel unterstützt diesen Vorgang nicht.
GET/services/{id}/toolsDienst-Tools Aktiviert

Die für Ihren Dienst verfügbaren Tools und die Aktionen, die jedes Tool unterstützt (capabilities). Die Tools unterscheiden sich je nach Panel.

Berechtigung: Services/GetServiceToolsGET https://hanhosting.com/api/v1/client/services/{id}/tools
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": [
    { "key": "email-accounts", "group": "email", "label": "Email Accounts", "capabilities": ["create", "delete", "password", "quota"], "url": "" },
    { "key": "databases", "group": "database", "label": "Databases", "capabilities": ["create", "delete"], "url": "" }
  ]
}
Endpunktspezifische Fehler
HTTPCodeBedeutung
422not_actionableDer Dienst ist nicht aktiv.
422tools_not_supportedDas Panel des Dienstes unterstützt keine Tools.

Einige der Webhosting-Tools (cPanel): file-manager, ftp-accounts, databases, subdomains, addon-domains, domain-redirects, dns-zone-editor, email-accounts, email-forwarders, php-version, cron-jobs, ssl-management. VDS-Dienste (virtuelle Server) haben start-server, stop-server, restart-server, reset-password, reinstall-os und vnc-console; zur VNC-Konsole siehe das Szenario VNC-Konsole für VDS. Rufen Sie für die aktuelle Liste immer diesen Endpunkt auf.

GET/services/{id}/tools/{tool}Tool-Daten lesen Aktiviert

Liefert die Daten des Tools (z. B. die Liste der E-Mail-Konten). Zusätzliche Query-Parameter werden an das Tool weitergegeben.

Berechtigung: Services/GetServiceToolDataGET https://hanhosting.com/api/v1/client/services/{id}/tools/{tool}
Query-Parameter
FeldTypBeschreibung
toolPflichtfeldstringTool-Schlüssel (im Pfad), z. B. email-accounts
actionstringLeseaktion, Standard index
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": { "accounts": [ { "email": "[email protected]", "quota": "1024", "used": "12.4" } ] } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
404not_foundDas Tool existiert nicht oder wird nicht unterstützt.
500tool_data_failedDas Panel konnte die Daten nicht liefern (z. B. weil das Tool deaktiviert ist).

Die Struktur der Antwort unterscheidet sich je nach Tool und Panel.

POST/services/{id}/tools/{tool}/{action}Tool-Aktion ausführen Aktiviert

Führt eine der Aktionen des Tools aus (Anlegen, Löschen, Bearbeiten ...). Die Body-Felder hängen vom Tool und von der Aktion ab; die Aktion muss in der Liste capabilities des Tools enthalten sein.

Berechtigung: Services/RunServiceToolActionPOST https://hanhosting.com/api/v1/client/services/{id}/tools/{tool}/{action}
Body-Felder (JSON)
FeldTypBeschreibung
toolPflichtfeldstringTool-Schlüssel (im Pfad)
actionPflichtfeldstringAktion (im Pfad), z. B. create, delete
…objectAktionsspezifische Felder. Beispiele: email-accounts/create → email, password, domain; databases/create → name; dns-zone-editor/create → name, type, record; cron-jobs/create → minute, hour, day, month, weekday, command; ssl-management/create → domain, type.
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/tools/databases/create" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "name": "magaza" }'
Beispielantwort
HTTP 200
{ "data": { "status": "successful", "message": "Database created." } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
422tools_not_supported, tool_rejectedDer Dienst unterstützt dieses Tool nicht, oder der Vorgang wurde abgelehnt.
500tool_action_failedDas Panel hat den Vorgang abgelehnt: ein fehlendes Feld, eine nicht unterstützte Aktion oder ein Panel-Fehler. message enthält die Meldung des Panels.

Der Vorgang nimmt echte Änderungen im Panel vor und wird im Dienstverlauf protokolliert. VDS-Beispiel: POST /services/{id}/tools/start-server/execute startet die Maschine, und POST /services/{id}/tools/vnc-console/create liefert eine einmalig nutzbare URL für die VNC-Konsole (Details).

POST/services/{id}/ssoURL für den Panel-Login mit einem Klick Aktiviert

Erzeugt eine kurzlebige URL, die Sie direkt im Control Panel des Dienstes anmeldet. Kein Body erforderlich.

Berechtigung: Services/GetServiceSsoPOST https://hanhosting.com/api/v1/client/services/{id}/sso
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/sso" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{ "data": { "url": "https://…/login?token=…" } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
422sso_not_supportedDas Panel unterstützt keinen Login mit einem Klick.
500sso_failedDie URL konnte nicht erzeugt werden.

Verwenden Sie die URL sofort; speichern Sie sie nicht und schreiben Sie sie nicht in Logdateien.

POST/services/{id}/passwordPasswort des Dienstes ändern Aktiviert

Ändert bei Hosting- und Serverdiensten das Passwort im Panel und aktualisiert unsere Datensätze.

Berechtigung: Services/ChangeServicePasswordPOST https://hanhosting.com/api/v1/client/services/{id}/password
Body-Felder (JSON)
FeldTypBeschreibung
passwordPflichtfeldstringNeues Passwort. Es gilt eine Mindestlänge; manche Panels wenden zusätzliche Regeln an. Auf VDS-Servern muss das Passwort 8–14 Zeichen lang sein und darf als Sonderzeichen nur ! @ _ - . enthalten.
Beispielanfrage
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/password" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "password": "Guclu.Parola26" }'
Beispielantwort
HTTP 200
{ "data": { "changed": true, "service_id": 1204 } }
Endpunktspezifische Fehler
HTTPCodeBedeutung
422password_not_supportedDer Diensttyp unterstützt keine Passwortänderungen.
422password_too_shortDas Passwort ist zu kurz; details.min gibt die Mindestlänge an.
422password_change_failedDas Panel hat das Passwort abgelehnt; die Meldung nennt die Regel des Panels.
PATCH/services/{id}Diensteinstellungen Deaktiviert

Automatische Verlängerung (auto_renew) und Rechnungsadresse (billing_profile_id).

Berechtigung: Services/UpdateServicePATCH https://hanhosting.com/api/v1/client/services/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/services/{id}/metricsNutzungsmetriken Deaktiviert

Nutzung und geschätzte Kosten nutzungsbasiert abgerechneter Metriken.

Berechtigung: Services/GetServiceMetricsGET https://hanhosting.com/api/v1/client/services/{id}/metrics

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/services/{id}/metrics/billingAbrechnungsverlauf der Metriken Deaktiviert

Nutzung und abgerechnete Beträge pro Zeitraum.

Berechtigung: Services/GetServiceMetricBillingGET https://hanhosting.com/api/v1/client/services/{id}/metrics/billing

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PATCH/services/{id}/metrics/{key}Metrik aktivieren/deaktivieren Deaktiviert

{"enabled": true}

Berechtigung: Services/UpdateServiceMetricPATCH https://hanhosting.com/api/v1/client/services/{id}/metrics/{key}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/services/{id}/module-methodPanel-Methode aufrufen Deaktiviert

Führt die benutzerdefinierten Methoden des Panels aus, die für Kunden verfügbar sind.

Berechtigung: Services/UseServiceModuleMethodPOST https://hanhosting.com/api/v1/client/services/{id}/module-method

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Konto

Konto- und Profilinformationen. 1 / 5 aktiviert

GET/meIhre Kontoinformationen Aktiviert

Profil-, Kontakt- und Rechnungsdaten (Firma), Währung und aktuelles Guthaben. meta.editable listet die bearbeitbaren Felder auf, meta.required die Pflichtfelder.

Berechtigung: Account/GetMeGET https://hanhosting.com/api/v1/client/me
Beispielanfrage
curl -s "https://hanhosting.com/api/v1/client/me" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Beispielantwort
HTTP 200
{
  "data": {
    "id": 1001,
    "kind": "corporate",
    "full_name": "Name Surname",
    "name": "Name",
    "surname": "Surname",
    "company": { "name": "Example IT Ltd.", "tax_number": "1234567890", "tax_office": "Kadikoy" },
    "email": "[email protected]",
    "email_verified": true,
    "phone": "5321234567",
    "phone_country_code": "90",
    "phone_verified": true,
    "language": "tr",
    "country": "TR",
    "currency": "TRY",
    "balance": { "amount": 2500.00, "currency": "TRY" },
    "timezone": "Europe/Istanbul",
    "custom_fields": [],
    "created_at": "2025-06-21 11:44:00",
    "last_login_at": "2026-10-01 09:12:40"
  },
  "meta": { "editable": ["name", "surname", "phone", "language"], "required": ["phone"] }
}

Die Antwort enthält außerdem die Felder avatar_url, landline_phone, identity, birthday, date_format und group_id.

PATCH/meKontoinformationen aktualisieren Deaktiviert

Vorname, Nachname, Firma, Telefon, Sprache, Land, Währung, Zeitzone, benutzerdefinierte Felder und Profilbild (base64). Die E-Mail-Adresse kann mit diesem Endpunkt nicht geändert werden.

Berechtigung: Account/UpdateMePATCH https://hanhosting.com/api/v1/client/me

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/me/securitySicherheitsstatus Deaktiviert

E-Mail- und Telefonverifizierung, Zwei-Faktor-Authentifizierung und aktive Sitzungen.

Berechtigung: Account/GetSecurityGET https://hanhosting.com/api/v1/client/me/security

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/me/notificationsBenachrichtigungseinstellungen Deaktiviert

Benachrichtigungseinstellungen für E-Mail und SMS je Kategorie.

Berechtigung: Account/GetNotificationsGET https://hanhosting.com/api/v1/client/me/notifications

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/me/notificationsBenachrichtigungseinstellungen aktualisieren Deaktiviert

In der Form {"invoices": {"email": true, "sms": false}}; nicht gesendete Kategorien werden deaktiviert.

Berechtigung: Account/UpdateNotificationsPUT https://hanhosting.com/api/v1/client/me/notifications

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Domains

Domainabfrage, Registrierung, Transfer sowie Verwaltung von Nameservern, DNS und WHOIS. 0 / 43 aktiviert

Diese Gruppe ist für Ihr Konto derzeit deaktiviert. Die Endpunkte sind zur Information aufgeführt; wenn Sie sie nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/tldsDomainendungen und Preise Deaktiviert

Preise für Registrierung, Transfer und Verlängerung; Preise pro Jahr mit ?tld=com.

Berechtigung: Domains/GetTldsGET https://hanhosting.com/api/v1/client/domains/tlds

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/checkDomain prüfen Deaktiviert

{"domain": "ornekfirma.com"} → Verfügbarkeit, Premium-Status und Registrierungspreis.

Berechtigung: Domains/CheckDomainPOST https://hanhosting.com/api/v1/client/domains/check

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/registerDomain registrieren Deaktiviert

Registrierungsauftrag mit Laufzeit in Jahren, Nameservern, WHOIS-Kontakten und Zusatzdiensten; Zahlung per Guthaben.

Berechtigung: Domains/RegisterDomainPOST https://hanhosting.com/api/v1/client/domains/register

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/transferDomaintransfer Deaktiviert

Auftrag für einen eingehenden Transfer mit EPP-Code (Transfercode).

Berechtigung: Domains/TransferDomainPOST https://hanhosting.com/api/v1/client/domains/transfer

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domainsDomainliste Deaktiviert

Mit status=expiring die Domains, die innerhalb von 30 Tagen ablaufen.

Berechtigung: Domains/GetDomainsGET https://hanhosting.com/api/v1/client/domains

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}Domaindetails Deaktiviert

Der Pfadparameter kann die Dienst-ID oder der Domainname selbst sein. Sperre, Datenschutz, Nameserver, Funktionen, Verlängerungsoptionen.

Berechtigung: Domains/GetDomainGET https://hanhosting.com/api/v1/client/domains/{domain}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PATCH/domains/{domain}Domaineinstellungen Deaktiviert

Automatische Verlängerung und Rechnungsadresse.

Berechtigung: Domains/UpdateDomainPATCH https://hanhosting.com/api/v1/client/domains/{domain}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/renewDomain verlängern Deaktiviert

{"years": 1} → Verlängerungsrechnung.

Berechtigung: Domains/RenewDomainPOST https://hanhosting.com/api/v1/client/domains/{domain}/renew

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/transfer-statusTransferstatus Deaktiviert
Berechtigung: Domains/GetTransferStatusGET https://hanhosting.com/api/v1/client/domains/{domain}/transfer-status

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/nameserversNameserver Deaktiviert
Berechtigung: Domains/GetNameserversGET https://hanhosting.com/api/v1/client/domains/{domain}/nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/nameserversNameserver ändern Deaktiviert

{"nameservers": ["ns1.hanhosting.com", "ns2.hanhosting.com"]} (2–4 Einträge).

Berechtigung: Domains/UpdateNameserversPUT https://hanhosting.com/api/v1/client/domains/{domain}/nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/child-nameserversChild-Nameserver Deaktiviert
Berechtigung: Domains/GetChildNameserversGET https://hanhosting.com/api/v1/client/domains/{domain}/child-nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/child-nameserversChild-Nameserver hinzufügen Deaktiviert

{"host": "ns1.ornekfirma.com", "ip": "…"}

Berechtigung: Domains/CreateChildNameserverPOST https://hanhosting.com/api/v1/client/domains/{domain}/child-nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/{domain}/child-nameserversChild-Nameserver löschen Deaktiviert
Berechtigung: Domains/DeleteChildNameserverDELETE https://hanhosting.com/api/v1/client/domains/{domain}/child-nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/transfer-lockStatus der Transfersperre Deaktiviert
Berechtigung: Domains/GetTransferLockGET https://hanhosting.com/api/v1/client/domains/{domain}/transfer-lock

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/transfer-lockTransfersperre ein-/ausschalten Deaktiviert

{"locked": true}

Berechtigung: Domains/UpdateTransferLockPUT https://hanhosting.com/api/v1/client/domains/{domain}/transfer-lock

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/auth-codeTransfercode per E-Mail senden Deaktiviert
Berechtigung: Domains/SendAuthCodePOST https://hanhosting.com/api/v1/client/domains/{domain}/auth-code

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/auth-codeCode für einen eingehenden Transfer speichern Deaktiviert
Berechtigung: Domains/SaveAuthCodePUT https://hanhosting.com/api/v1/client/domains/{domain}/auth-code

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/dns-recordsDNS-Einträge Deaktiviert

Erfordert das Add-on für die DNS-Verwaltung.

Berechtigung: Domains/GetDnsRecordsGET https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/dns-recordsDNS-Eintrag hinzufügen Deaktiviert

{"type": "A", "name": "www", "value": "…", "ttl": 3600}

Berechtigung: Domains/CreateDnsRecordPOST https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/dns-recordsDNS-Eintrag aktualisieren Deaktiviert
Berechtigung: Domains/UpdateDnsRecordPUT https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/{domain}/dns-recordsDNS-Eintrag löschen Deaktiviert
Berechtigung: Domains/DeleteDnsRecordDELETE https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/dnssecDNSSEC-Einträge Deaktiviert
Berechtigung: Domains/GetDnssecRecordsGET https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/dnssecDNSSEC-Eintrag hinzufügen Deaktiviert
Berechtigung: Domains/CreateDnssecRecordPOST https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/{domain}/dnssecDNSSEC-Eintrag löschen Deaktiviert
Berechtigung: Domains/DeleteDnssecRecordDELETE https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/whoisWHOIS-Kontakte Deaktiviert
Berechtigung: Domains/GetWhoisContactsGET https://hanhosting.com/api/v1/client/domains/{domain}/whois

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/whoisWHOIS-Kontakte aktualisieren Deaktiviert
Berechtigung: Domains/UpdateWhoisContactsPUT https://hanhosting.com/api/v1/client/domains/{domain}/whois

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/whois/applyWHOIS-Profil anwenden Deaktiviert
Berechtigung: Domains/ApplyWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/{domain}/whois/apply

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/whois-privacyWHOIS-Datenschutz Deaktiviert
Berechtigung: Domains/UpdateWhoisPrivacyPUT https://hanhosting.com/api/v1/client/domains/{domain}/whois-privacy

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/email-forwardsE-Mail-Weiterleitungen Deaktiviert
Berechtigung: Domains/GetEmailForwardsGET https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/email-forwardsE-Mail-Weiterleitung hinzufügen Deaktiviert
Berechtigung: Domains/CreateEmailForwardPOST https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/{domain}/email-forwardsE-Mail-Weiterleitung löschen Deaktiviert
Berechtigung: Domains/DeleteEmailForwardDELETE https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/{domain}/forwardingURL-Weiterleitung Deaktiviert
Berechtigung: Domains/GetUrlForwardingGET https://hanhosting.com/api/v1/client/domains/{domain}/forwarding

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/{domain}/forwardingURL-Weiterleitung einrichten Deaktiviert

{"url": "https://…", "method": 301}

Berechtigung: Domains/UpdateUrlForwardingPUT https://hanhosting.com/api/v1/client/domains/{domain}/forwarding

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/{domain}/forwardingURL-Weiterleitung entfernen Deaktiviert
Berechtigung: Domains/DeleteUrlForwardingDELETE https://hanhosting.com/api/v1/client/domains/{domain}/forwarding

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/{domain}/addons/{key}Domain-Add-on kaufen Deaktiviert

dns-management, whois-privacy, forwarding; anteilige Rechnung auf Basis der verbleibenden Laufzeit.

Berechtigung: Domains/BuyDomainAddonPOST https://hanhosting.com/api/v1/client/domains/{domain}/addons/{key}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/whois-profilesWHOIS-Profile Deaktiviert
Berechtigung: Domains/GetWhoisProfilesGET https://hanhosting.com/api/v1/client/domains/whois-profiles

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/whois-profilesWHOIS-Profil erstellen Deaktiviert
Berechtigung: Domains/CreateWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/whois-profiles

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/whois-profiles/{pid}WHOIS-Profil aktualisieren Deaktiviert
Berechtigung: Domains/UpdateWhoisProfilePUT https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/domains/whois-profiles/{pid}WHOIS-Profil löschen Deaktiviert
Berechtigung: Domains/DeleteWhoisProfileDELETE https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/domains/whois-profiles/{pid}/defaultStandard-WHOIS-Profil Deaktiviert
Berechtigung: Domains/SetDefaultWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}/default

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/domains/default-nameserversStandard-Nameserver Deaktiviert
Berechtigung: Domains/GetDefaultNameserversGET https://hanhosting.com/api/v1/client/domains/default-nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/domains/default-nameserversStandard-Nameserver ändern Deaktiviert
Berechtigung: Domains/UpdateDefaultNameserversPUT https://hanhosting.com/api/v1/client/domains/default-nameservers

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Rechnungsadressen

Gespeicherte Rechnungsadressen. 0 / 6 aktiviert

Diese Gruppe ist für Ihr Konto derzeit deaktiviert. Die Endpunkte sind zur Information aufgeführt; wenn Sie sie nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/addressesRechnungsadressen Deaktiviert
Berechtigung: Addresses/GetAddressesGET https://hanhosting.com/api/v1/client/addresses

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/addressesAdresse hinzufügen Deaktiviert

Erforderlich: Vorname, Nachname, E-Mail, Land, Provinz, Bezirk, Adresse, Postleitzahl; bei einer Firmenadresse zusätzlich der Firmenname.

Berechtigung: Addresses/CreateAddressPOST https://hanhosting.com/api/v1/client/addresses

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/addresses/{id}Adressdetails Deaktiviert
Berechtigung: Addresses/GetAddressGET https://hanhosting.com/api/v1/client/addresses/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/addresses/{id}Adresse aktualisieren Deaktiviert
Berechtigung: Addresses/UpdateAddressPUT https://hanhosting.com/api/v1/client/addresses/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

DELETE/addresses/{id}Adresse löschen Deaktiviert
Berechtigung: Addresses/DeleteAddressDELETE https://hanhosting.com/api/v1/client/addresses/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/addresses/{id}/defaultAls Standardadresse festlegen Deaktiviert
Berechtigung: Addresses/SetDefaultAddressPOST https://hanhosting.com/api/v1/client/addresses/{id}/default

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Support-Tickets

Support-Tickets eröffnen, beantworten und schließen. 0 / 11 aktiviert

Diese Gruppe ist für Ihr Konto derzeit deaktiviert. Die Endpunkte sind zur Information aufgeführt; wenn Sie sie nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/tickets/departmentsSupport-Abteilungen Deaktiviert
Berechtigung: Tickets/GetTicketDepartmentsGET https://hanhosting.com/api/v1/client/tickets/departments

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/tickets/access-groupsGruppen für Zugangsdaten Deaktiviert
Berechtigung: Tickets/GetTicketAccessGroupsGET https://hanhosting.com/api/v1/client/tickets/access-groups

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/ticketsSupport-Tickets Deaktiviert
Berechtigung: Tickets/GetTicketsGET https://hanhosting.com/api/v1/client/tickets

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/ticketsSupport-Ticket eröffnen Deaktiviert

Abteilung, Betreff, Nachricht; optional Dienst, Priorität und Anhänge in base64.

Berechtigung: Tickets/CreateTicketPOST https://hanhosting.com/api/v1/client/tickets

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/tickets/{id}Ticketdetails und Nachrichten Deaktiviert
Berechtigung: Tickets/GetTicketGET https://hanhosting.com/api/v1/client/tickets/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/tickets/{id}/replyTicket beantworten Deaktiviert
Berechtigung: Tickets/ReplyTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/reply

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/tickets/{id}/closeTicket schließen Deaktiviert
Berechtigung: Tickets/CloseTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/close

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/tickets/{id}/reopenTicket wieder eröffnen Deaktiviert
Berechtigung: Tickets/ReopenTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/reopen

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/tickets/{id}/ratingTicket bewerten Deaktiviert
Berechtigung: Tickets/RateTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/rating

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/tickets/{id}/replies/{rid}/ratingAntwort bewerten Deaktiviert
Berechtigung: Tickets/RateTicketReplyPOST https://hanhosting.com/api/v1/client/tickets/{id}/replies/{rid}/rating

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/tickets/{id}/attachments/{aid}Anhang herunterladen (base64) Deaktiviert
Berechtigung: Tickets/GetTicketAttachmentGET https://hanhosting.com/api/v1/client/tickets/{id}/attachments/{aid}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

SMS

Versand von SMS-Nachrichten und Versandprotokolle. 0 / 5 aktiviert

Diese Gruppe ist für Ihr Konto derzeit deaktiviert. Die Endpunkte sind zur Information aufgeführt; wenn Sie sie nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/sms/sendersAbsendernamen Deaktiviert
Berechtigung: Sms/GetSmsSendersGET https://hanhosting.com/api/v1/client/sms/senders

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/sms/quoteSMS-Preis berechnen Deaktiviert
Berechtigung: Sms/QuoteSmsPOST https://hanhosting.com/api/v1/client/sms/quote

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/sms/sendSMS senden Deaktiviert

Der Betrag wird von Ihrem Guthaben abgebucht und erstattet, falls der Versand fehlschlägt.

Berechtigung: Sms/SendSmsPOST https://hanhosting.com/api/v1/client/sms/send

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/sms/messagesGesendete SMS-Nachrichten Deaktiviert
Berechtigung: Sms/GetSmsMessagesGET https://hanhosting.com/api/v1/client/sms/messages

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/sms/messages/{id}SMS-Details Deaktiviert
Berechtigung: Sms/GetSmsMessageGET https://hanhosting.com/api/v1/client/sms/messages/{id}

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Partnerprogramm

Partnerprogramm und Provisionen. 0 / 5 aktiviert

Diese Gruppe ist für Ihr Konto derzeit deaktiviert. Die Endpunkte sind zur Information aufgeführt; wenn Sie sie nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/affiliatePartnerübersicht Deaktiviert
Berechtigung: Affiliate/GetAffiliateGET https://hanhosting.com/api/v1/client/affiliate

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

GET/affiliate/commissionsProvisionen Deaktiviert
Berechtigung: Affiliate/GetAffiliateCommissionsGET https://hanhosting.com/api/v1/client/affiliate/commissions

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/affiliate/enrollAm Programm teilnehmen Deaktiviert
Berechtigung: Affiliate/EnrollAffiliatePOST https://hanhosting.com/api/v1/client/affiliate/enroll

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

POST/affiliate/withdrawAuszahlung anfordern Deaktiviert
Berechtigung: Affiliate/WithdrawAffiliatePOST https://hanhosting.com/api/v1/client/affiliate/withdraw

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

PUT/affiliate/payment-methodAuszahlungsmethode speichern Deaktiviert
Berechtigung: Affiliate/SaveAffiliatePayoutMethodPUT https://hanhosting.com/api/v1/client/affiliate/payment-method

Dieser Endpunkt ist für Ihr Konto derzeit nicht aktiviert; er erscheint nicht in den Schlüsselberechtigungen und liefert beim Aufruf 403. Wenn Sie ihn nutzen möchten, eröffnen Sie ein Support-Ticket.

Sicherheit und Best Practices

  • Erstellen Sie für jede Integration einen eigenen Schlüssel und erteilen Sie nur die benötigten Berechtigungen; geben Sie zum Beispiel einem Reporting-Tool, das nur Daten liest, nicht die Berechtigung Orders/CreateOrder.
  • Binden Sie den Schlüssel an die IP-Adresse Ihres Servers.
  • Verwenden Sie Idempotency-Key bei jeder POST-Anfrage, die Geld bewegt.
  • Prüfen Sie die Summe vor der Bestellung mit POST /orders/preview; kommt ein unerwarteter Betrag zurück, senden Sie die Bestellung nicht ab.
  • Zugangsdaten von Diensten (access.password) werden im Klartext zurückgegeben; speichern Sie sie nur in einer verschlüsselten Umgebung und schreiben Sie sie nicht in Logdateien.
  • Wenn Sie vermuten, dass der Schlüssel offengelegt wurde, verwenden Sie auf der Schlüsselseite sofort Revoke oder Regenerate.
Kontakt

So erreichen Sie Vertrieb & Support

Sie haben vor dem Kauf eine Frage oder brauchen Hilfe mit einem bestehenden Konto? Rufen Sie uns an oder schreiben Sie uns eine E-Mail.