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.
Ü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.
Basis-URL
https://hanhosting.com/api/v1/clientAlle 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.
- Öffnen Sie die Schlüsselseite. Kundenbereich → API Credentials → Create API Key.
- 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 FormatGroup/Action(z. B.Orders/CreateOrder). - 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. - 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.
| Berechtigung | Endpunkt | Funktion |
|---|---|---|
Account/GetMe | GET /me | Ihre Kontoinformationen |
Products/GetProducts | GET /products | Produktliste |
Products/GetProductCategories | GET /products/categories | Produktkategorien |
Products/GetProduct | GET /products/{id} | Produktdetails und Bestelloptionen |
Orders/PreviewOrder | POST /orders/preview | Bestellsumme berechnen (Vorschau) |
Orders/CreateOrder | POST /orders | Bestellung anlegen und bezahlen |
Orders/GetOrders | GET /orders | Bestellliste |
Orders/GetOrder | GET /orders/{id} | Bestelldetails |
Invoices/GetInvoices | GET /invoices | Rechnungsliste |
Invoices/GetInvoice | GET /invoices/{id} | Rechnungsdetails |
Invoices/PayInvoice | POST /invoices/{id}/pay | Rechnung per Guthaben bezahlen |
Balance/GetBalance | GET /balance | Guthaben |
Balance/GetBalanceTransactions | GET /balance/transactions | Guthabenbewegungen |
Services/GetServices | GET /services | Dienstliste |
Services/GetService | GET /services/{id} | Dienstdetails und Zugangsdaten |
Services/RenewService | POST /services/{id}/renew | Verlängerungsrechnung erstellen |
Services/GetServiceInvoices | GET /services/{id}/invoices | Rechnungen eines Dienstes |
Services/GetServiceAddons | GET /services/{id}/addons | Add-ons eines Dienstes |
Services/CreateCancellation | POST /services/{id}/cancellation | Kündigungsantrag stellen |
Services/RevokeCancellation | DELETE /services/{id}/cancellation | Kündigungsantrag zurückziehen |
Services/GetServiceDashboard | GET /services/{id}/dashboard | Panel-Übersicht des Dienstes |
Services/GetServiceTools | GET /services/{id}/tools | Dienst-Tools |
Services/GetServiceToolData | GET /services/{id}/tools/{tool} | Tool-Daten lesen |
Services/RunServiceToolAction | POST /services/{id}/tools/{tool}/{action} | Tool-Aktion ausführen |
Services/GetServiceSso | POST /services/{id}/sso | URL für den Panel-Login mit einem Klick |
Services/ChangeServicePassword | POST /services/{id}/password | Passwort 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:
Authorization: Bearer wck_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXManche 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"<?php
// Small client used by all examples. Do not hard-code the key; read it from an environment variable.
function hh_api(string $method, string $path, ?array $body = null, array $headers = []): array
{
$ch = curl_init('https://hanhosting.com/api/v1/client' . $path);
$h = array_merge([
'Authorization: Bearer ' . getenv('HANHOSTING_API_KEY'),
'Accept: application/json',
'Content-Type: application/json',
], $headers);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_HTTPHEADER => $h,
CURLOPT_TIMEOUT => 60,
]);
if ($body !== null) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
$raw = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$json = json_decode((string) $raw, true) ?: [];
if ($status >= 400) {
$e = $json['error'] ?? ['code' => 'http_' . $status, 'message' => 'Unexpected response'];
throw new RuntimeException($e['code'] . ': ' . $e['message'], $status);
}
return $json; // ['data' => ..., 'meta' => ...]
}
$ben = hh_api('GET', '/whoami');
print_r($ben['data']['permissions']);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/jsonhinzu. 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.
{
"data": [ { "id": 1204, "name": "HAN-MC-1", "status": "active" } ],
"meta": { "total": 37, "page": 1, "limit": 25, "next_page": 2 }
}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, wirdnullzurückgegeben. - Schlüssel der Abrechnungszeiträume (cycle):
monthly,quarterly,semiannually,annually,biennially,triennially,onetime(sowiehourly,daily,weeklybei stündlich, täglich oder wöchentlich abgerechneten Produkten).pricinginGET /products/{id}zeigt, mit welchen Zeiträumen ein Produkt verkauft wird.
HTTP-Statuscodes und allgemeine Fehlercodes
| HTTP | Code | Bedeutung und Vorgehen |
|---|---|---|
| 401 | missing_token | Es wurde kein Schlüssel gesendet. Fügen Sie Authorization: Bearer ... oder X-Api-Key hinzu. |
| 401 | invalid_token | Der Schlüssel wurde nicht erkannt oder ist fehlerhaft. Stellen Sie sicher, dass Sie den vollständigen Schlüssel kopiert haben. |
| 401 | key_revoked | Der Schlüssel wurde widerrufen. Erstellen Sie einen neuen Schlüssel. |
| 401 | owner_inactive | Ihr Konto ist nicht aktiv; wenden Sie sich an den Support. |
| 403 | ip_not_allowed | Die 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. |
| 403 | account_not_allowed | Ihr Konto steht nicht auf der Liste der Konten mit API-Zugang. Wenden Sie sich für den API-Zugang an den Support. |
| 403 | insufficient_scope | Dem 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. |
| 403 | client_api_not_allowed, client_scope_revoked, surface_disabled | Der 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. |
| 403 | audience_mismatch | Der 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. |
| 400 | operation_failed | Der Vorgang konnte nicht abgeschlossen werden; lesen Sie die Meldung und teilen Sie sie bei Bedarf dem Support mit. |
| 404 | endpoint_not_found, not_found | Die URL existiert nicht, oder der angeforderte Datensatz (Dienst, Rechnung, Bestellung ...) gehört nicht Ihnen. |
| 405 | method_not_allowed | Die URL ist korrekt, aber die HTTP-Methode ist falsch (z. B. GET statt POST). |
| 409 | idempotency_in_flight | Die vorherige Anfrage mit demselben Idempotency-Key wird noch verarbeitet; wiederholen Sie sie in Kürze mit demselben Schlüssel. |
| 413 | payload_too_large | Der Body ist zu groß (meist wegen großer base64-Dateien). |
| 422 | idempotency_key_invalid, idempotency_key_reuse | Idempotency-Key ist nicht 8–191 Zeichen lang, oder derselbe Schlüssel wurde mit einem anderen Body verwendet. Siehe Idempotente Anfragen. |
| 422 | validation_failed und endpunktspezifische Codes | Die 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. |
| 429 | rate_limited | Das Anfragelimit pro Minute wurde überschritten. Warten Sie die in Retry-After angegebene Zeit ab. |
| 429 | abuse_lockout, too_many_auth_failures | Vorübergehende Sperre (15 Minuten) wegen übermäßiger Last oder zu vieler fehlgeschlagener Authentifizierungsversuche. |
| 500 | server_error und endpunktspezifische Codes | Ein 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
/pingund 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 gibtRetry-Afteran, 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) undlimit(1–100, Standard 25). - Das Objekt
metain der Antwort:total(Gesamtzahl der Datensätze),page,limit,next_page(auf der letzten Seite0). searchdurchsucht 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
sortunddir.
$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_flightzurü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.
Idempotency-Key: bayi-siparis-2026-000184Szenario: automatische Bestellung mit Ihrem Guthaben
Der empfohlene Ablauf, um automatisch dasselbe Paket bei uns zu kaufen, wenn Ihr Kunde bei Ihnen ein Paket kauft:
- Produkt und Optionen abrufen:
GET /products/{id}.pricingzeigt die angebotenen Zeiträume,requirementsundaddonsdie Auswahlen, die Sie mit der Bestellung senden müssen, unddomain.mode, ob eine Domain benötigt wird. - Guthaben prüfen:
GET /balance. - Summe berechnen:
POST /orders/previewliefert die Summe einschließlich Gutscheinen und Steuern, ohne eine Bestellung anzulegen. - 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. - Bereitstellung verfolgen: Entnehmen Sie die Dienst-ID aus
services[]inGET /orders/{id}; sobaldGET /services/{id}den Statusactivezeigt, geben Sie die Zugangsdaten (access) an Ihren Kunden weiter.
$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
GET /services/{id}→ die verlängerbaren Zeiträume sehen Sie inrenewal.availableundrenewal.cycles. Hat der Dienst eine offene Rechnung, istrenewal.open_invoice_idgesetzt.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 mitexisting: truezurückgegeben.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}/ssoliefert 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}/dashboardliefert den Panel-Namen, die verfügbaren Aktionen und die Ressourcenanzeigen. - Dienst-Tools:
GET /services/{id}/toolslistet die für Ihren Dienst verfügbaren Tools und die Aktionen jedes Tools auf (capabilities). Verwenden SieGET /services/{id}/tools/{tool}zum Lesen von Daten undPOST /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 -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.
- Zustand der Maschine abrufen:
GET /services/{id}/tools/vnc-console. Das Feldpowerliefertrunning,stopped,installingodersuspended. Ist die Maschine ausgeschaltet, starten Sie sie zuerst mitPOST /services/{id}/tools/start-server/execute; läuft gerade eine Installation, warten Sie, bis sie abgeschlossen ist. - Verbindungs-URL abrufen:
POST /services/{id}/tools/vnc-console/create(kein Body erforderlich). Das Felddata.urlin der Antwort ist eine einmalig nutzbare URL der Formwss://console.hanhosting.com/…/beconsole/…. - 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 -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"{ "data": { "status": "successful", "url": "wss://console.hanhosting.com/4/beconsole/…" } }// 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_failedmit 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_failedmit 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.
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.
curl -s "https://hanhosting.com/api/v1/client/ping" \
-H "Accept: application/json"$r = hh_api('GET', '/ping');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/ping', {
method: 'GET',
headers: {
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/ping',
headers={
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "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.
curl -s "https://hanhosting.com/api/v1/client/whoami" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/whoami');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/whoami', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/whoami',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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.
curl -s "https://hanhosting.com/api/v1/client/reference/countries" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/reference/countries');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/reference/countries', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/reference/countries',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": [ { "code": "TR", "name": "Turkey" }, { "code": "DE", "name": "Germany" } ] }GET/reference/countries/{code}/statesProvinzen eines Landes Keine Berechtigung erforderlich
| Feld | Typ | Beschreibung |
|---|---|---|
codePflichtfeld | string | Ländercode (ISO-2), z. B. TR |
curl -s "https://hanhosting.com/api/v1/client/reference/countries/TR/states" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/reference/countries/TR/states');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/reference/countries/TR/states', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/reference/countries/TR/states',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": [ { "id": 34, "name": "Istanbul" }, { "id": 6, "name": "Ankara" } ] }| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Ländercode nicht gefunden. |
GET/reference/states/{id}/citiesBezirke einer Provinz Keine Berechtigung erforderlich
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Provinz-ID (aus der Antwort von GetStates) |
curl -s "https://hanhosting.com/api/v1/client/reference/states/34/cities" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/reference/states/34/cities');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/reference/states/34/cities', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/reference/states/34/cities',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": [ { "id": 1103, "name": "Kadikoy" }, { "id": 1104, "name": "Uskudar" } ] }| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Provinz 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.
| Feld | Typ | Beschreibung |
|---|---|---|
type | string | Produkttyp: hosting, server, software, special ... Ein ungültiger Typ liefert 422 type_invalid zusammen mit den zulässigen Typen. |
category | integer | Kategorie-ID (GetProductCategories). |
search | string | Durchsucht die Produktnamen. |
page, limit | integer | Paginierung (limit 1–100, Standard 25). |
curl -s "https://hanhosting.com/api/v1/client/products?category=35" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/products?category=35');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/products?category=35', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/products?category=35',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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
| Feld | Typ | Beschreibung |
|---|---|---|
type | string | Nur Kategorien dieses Typs. |
curl -s "https://hanhosting.com/api/v1/client/products/categories" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/products/categories');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/products/categories', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/products/categories',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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).
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Produkt-ID |
curl -s "https://hanhosting.com/api/v1/client/products/176" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/products/176');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/products/176', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/products/176',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Das 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.
| Feld | Typ | Beschreibung |
|---|---|---|
itemsPflichtfeld | array | Bestellpositionen; gleiche Struktur wie bei POST /orders. |
coupons | array | Gutscheincodes. |
billing_profile_id | integer | Gespeicherte Rechnungsadresse (bestimmt den Steuersatz). |
payment | object | {"method": "balance"}; dient nur dazu, die Gebühr der Zahlungsmethode (fee) in die Berechnung einzubeziehen. |
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" } }
]
}'$r = hh_api('POST', '/orders/preview', [
'items' => [
[
'product_id' => 176,
'cycle' => 'monthly',
'requirements' => [
'3' => '0',
],
],
],
]);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/orders/preview', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"items": [
{ "product_id": 176, "cycle": "monthly", "requirements": { "3": "0" } }
]
}),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/orders/preview',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
json={
'items': [
{
'product_id': 176,
'cycle': 'monthly',
'requirements': {
'3': '0',
},
},
],
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 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.
| Feld | Typ | Beschreibung |
|---|---|---|
termsPflichtfeld | boolean | Annahme des Dienstleistungsvertrags: muss als JSON-Wert true gesendet werden, andernfalls 422 terms_required. |
itemsPflichtfeld | array | Bis zu 20 Positionen. Die Felder einer Position sind unten aufgeführt. |
items[].product_idPflichtfeld | integer | Produkt-ID (muss im Verkauf sein). |
items[].cyclePflichtfeld | string | Schlüssel des Abrechnungszeitraums; einer der Werte aus der Liste pricing des Produkts. |
items[].quantity | integer | Standard 1. Wenn das Produkt keine Mengenauswahl erlaubt, wird 1 angenommen. |
items[].requirements | object | Bestellauswahl: {"3": "1", "5": "1"}. Eine Options-ID bei Auswahlfeldern, ein Array von IDs bei Checkboxen, Text bei Textfeldern. |
items[].requirement_files | object | Anforderungen, die eine Datei verlangen: {"<id>": "base64 or data-URI"}. |
items[].addons | object | Add-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_qty | object | Menge bei Add-ons, die nach Menge verkauft werden: {"11": 2}. |
items[].metrics | array | Metrik-IDs zum Aktivieren nutzungsbasiert abgerechneter Metriken. |
items[].domain | object | Bei Produkten mit domain.mode=chooser: {"option": "owned", "name": "ornekfirma.com"} oder {"option": "subdomain", "base": "…", "name": "etiket"}. Bei Lizenzprodukten: {"license_domain": "…"} oder {"license_ip": "…"}. |
paymentPflichtfeld | object | {"method": "balance"}. Nicht erforderlich, wenn die Summe 0 beträgt. |
coupons | array | Gutscheincodes. |
billing_profile_id | integer | Gespeicherte Rechnungsadresse; ohne Angabe wird die Kontoadresse verwendet. |
notes | string | Bestellnotiz (bis zu 1000 Zeichen). |
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"
}'$r = hh_api('POST', '/orders', [
'terms' => true,
'items' => [
[
'product_id' => 176,
'cycle' => 'monthly',
'requirements' => [
'3' => '1',
'5' => '1',
],
'addons' => [
'11' => 0,
],
],
],
'payment' => [
'method' => 'balance',
],
'notes' => 'Reseller customer #184',
], ['Idempotency-Key: bayi-islem-000184']);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/orders', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
body: JSON.stringify({
"terms": true,
"items": [
{
"product_id": 176,
"cycle": "monthly",
"requirements": { "3": "1", "5": "1" },
"addons": { "11": 0 }
}
],
"payment": { "method": "balance" },
"notes": "Reseller customer #184"
}),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/orders',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
json={
'terms': True,
'items': [
{
'product_id': 176,
'cycle': 'monthly',
'requirements': {
'3': '1',
'5': '1',
},
'addons': {
'11': 0,
},
},
],
'payment': {
'method': 'balance',
},
'notes': 'Reseller customer #184',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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"
}
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | terms_required | terms wurde nicht als true gesendet. |
| 422 | items_required, items_invalid, too_many_items | Keine Positionen, eine fehlerhafte Liste oder mehr als 20 Positionen. |
| 422 | item_invalid, product_required | Eine Position ist kein Objekt, oder product_id fehlt. |
| 422 | product_not_orderable | Das Produkt ist nicht im Verkauf. |
| 422 | cycle_invalid | Dieses Produkt bietet den Zeitraum nicht an; details.allowed listet die gültigen Zeiträume auf. |
| 422 | item_unpriced | Für diesen Zeitraum ist kein Preis festgelegt. |
| 422 | out_of_stock, order_limit_reached | Nicht vorrätig, oder das Bestelllimit für das Produkt ist erreicht. |
| 422 | addon_invalid, addon_option_invalid | Das Add-on gehört nicht zu diesem Produkt, oder die Option existiert nicht. |
| 422 | requirement_missing | Eine erforderliche Auswahl wurde nicht gesendet. |
| 422 | file_url_not_allowed, file_upload_failed | Für ein Dateifeld wurde eine URL angegeben, oder die base64-Datei konnte nicht gespeichert werden. |
| 422 | metric_invalid | Die Metrik gehört nicht zu diesem Produkt. |
| 422 | domain_required, domain_invalid, subdomain_invalid, subdomain_base_invalid | Die Domain-Auswahl fehlt oder ist ungültig. |
| 422 | license_domain_required, license_ip_required | Für ein Lizenzprodukt wurde keine Domain bzw. IP gesendet. |
| 422 | domain_acquisition_not_here | Neue Domain-Registrierungen und -Transfers sind mit diesem Endpunkt nicht möglich. |
| 422 | coupon_invalid | Der Gutschein ist ungültig oder kann auf diese Bestellung nicht angewendet werden. |
| 422 | payment_method_invalid, payment_method_unavailable | Die Zahlungsmethode fehlt, ist ungültig oder nicht verfügbar. Senden Sie balance. |
| 422 | insufficient_balance | Guthaben nicht ausreichend; die Bestellung wird nicht angelegt. details.required und details.available (Zahlen) werden zurückgegeben. |
| 422 | account_restricted, checkout_blocked | Ihr Konto ist für Bestellungen gesperrt. |
| 404 | not_found | Die 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.
| Feld | Typ | Beschreibung |
|---|---|---|
page, limit | integer | Paginierung. |
curl -s "https://hanhosting.com/api/v1/client/orders" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/orders');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/orders', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/orders',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Bestell-ID |
curl -s "https://hanhosting.com/api/v1/client/orders/3120" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/orders/3120');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/orders/3120', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/orders/3120',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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"
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Die 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.
| Feld | Typ | Beschreibung |
|---|---|---|
status | string | paid, unpaid, overdue, refunded, cancelled, waiting. |
search | string | Rechnungsnummer oder die Beschreibung der ersten Rechnungsposition. |
sort | string | created, due, price |
dir | string | asc / desc (Standard: desc) |
page, limit | integer | Paginierung. |
curl -s "https://hanhosting.com/api/v1/client/invoices?status=overdue" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/invoices?status=overdue');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/invoices?status=overdue', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/invoices?status=overdue',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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 }
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | status_invalid | Ungü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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Rechnungs-ID |
curl -s "https://hanhosting.com/api/v1/client/invoices/5902" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/invoices/5902');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/invoices/5902', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/invoices/5902',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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": []
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Die 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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Rechnungs-ID (im Pfad) |
payment.methodPflichtfeld | string | balance |
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" } }'$r = hh_api('POST', '/invoices/5902/pay', [
'payment' => [
'method' => 'balance',
],
], ['Idempotency-Key: bayi-islem-000184']);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/invoices/5902/pay', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
body: JSON.stringify({ "payment": { "method": "balance" } }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/invoices/5902/pay',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
json={
'payment': {
'method': 'balance',
},
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | invoice_not_payable | Die Rechnung ist nicht unbezahlt, oder es ist kein Betrag fällig. |
| 422 | subscription_collects | Diese Rechnung wird über ein Abonnement eingezogen. |
| 422 | balance_not_allowed | Eine Rechnung zur Guthabenaufladung kann nicht mit Guthaben bezahlt werden. |
| 422 | payment_method_invalid, payment_method_unavailable | Die Zahlungsmethode fehlt, ist ungültig oder nicht verfügbar. Senden Sie balance. |
| 422 | payment_rejected | Die Zahlung wurde abgelehnt. |
| 422 | insufficient_balance | Ihr Guthaben deckt den fälligen Betrag (einschließlich etwaiger Gebühren) nicht. |
| 429 | invoice_payment_in_progress | Dieselbe Rechnung wird gerade durch eine andere Anfrage bezahlt. |
| 500 | wallet_charge_failed | Die 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.
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.
curl -s "https://hanhosting.com/api/v1/client/balance" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/balance');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/balance', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/balance',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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
| Feld | Typ | Beschreibung |
|---|---|---|
type | string | up (Aufladung) / down (Ausgabe) |
search | string | Durchsucht die Beschreibungen. |
page, limit | integer | Paginierung. |
curl -s "https://hanhosting.com/api/v1/client/balance/transactions" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/balance/transactions');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/balance/transactions', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/balance/transactions',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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 }
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | type_invalid | Ungültiger Typ. |
PATCH/balance/settingsGuthabeneinstellungen Deaktiviert
Einstellungen für die automatische Zahlung per Guthaben, die Ersatzkarte und die Warnung bei niedrigem Guthaben.
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.
| Feld | Typ | Beschreibung |
|---|---|---|
status | string | active, pending, suspended, expired, cancelled |
type | string | hosting, server, software, special |
search | string | Durchsucht den Namen, die Domain oder den Servernamen. |
page, limit | integer | Paginierung. |
curl -s "https://hanhosting.com/api/v1/client/services?status=active" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services?status=active');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services?status=active', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services?status=active',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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).
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID |
curl -s "https://hanhosting.com/api/v1/client/services/1204" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Der 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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID (im Pfad) |
cycle | string | Verlängerungszeitraum; einer aus renewal.cycles. Ohne Angabe gilt der aktuelle Zeitraum. |
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" }'$r = hh_api('POST', '/services/1204/renew', [
'cycle' => 'annually',
], ['Idempotency-Key: bayi-islem-000184']);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/renew', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
body: JSON.stringify({ "cycle": "annually" }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/renew',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
json={
'cycle': 'annually',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | cycle_invalid | Dieser Zeitraum wird für die Verlängerung nicht angeboten. |
| 422 | not_renewable | Der Dienst hat nicht den Status aktiv, abgelaufen oder gekündigt. |
| 422 | already_invoiced | Dieser Zeitraum wurde bereits in Rechnung gestellt. |
| 422 | renew_blocked_subscription | Der Dienst wird über ein Abonnement verlängert. |
| 422 | renew_disabled, renew_rejected | Für diesen Dienst kann keine Verlängerungsrechnung ausgestellt werden. |
| 422 | account_restricted | Ihr Konto ist für Verlängerungen gesperrt. |
| 500 | renew_failed | Die 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
| Feld | Typ | Beschreibung |
|---|---|---|
limit | integer | 1–100, Standard 25 |
curl -s "https://hanhosting.com/api/v1/client/services/1204/invoices" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/invoices');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/invoices', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/invoices',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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.).
curl -s "https://hanhosting.com/api/v1/client/services/1204/addons" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/addons');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/addons', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/addons',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID |
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade-options" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/upgrade-options');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/upgrade-options', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/upgrade-options',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Der Dienst existiert nicht oder gehört nicht Ihnen. |
| 422 | service_not_active | Nur aktive Dienste können ein Upgrade erhalten. |
| 403 | upgrades_disabled | Für diesen Diensttyp sind Upgrades deaktiviert. |
| 403 | insufficient_scope | Dem 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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID (im Pfad) |
product_idPflichtfeld | integer | Zielpaket aus der Liste upgrade-options |
price_id | integer | Abrechnungszeitraum; ohne Angabe der aktuelle Zeitraum des Dienstes (z. B. monthly) |
pay_with_balance | boolean | Standard true. Mit false bleibt die Rechnung unbezahlt; das Upgrade beginnt, sobald sie mit POST /invoices/{id}/pay bezahlt wurde. |
dry_run | boolean | true: nur prüfen und Preis berechnen; es wird weder ein Datensatz noch eine Rechnung angelegt |
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 }'$r = hh_api('POST', '/services/1204/upgrade', [
'product_id' => 110,
], ['Idempotency-Key: bayi-islem-000184']);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/upgrade', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
body: JSON.stringify({ "product_id": 110 }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/upgrade',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
'Idempotency-Key': 'bayi-islem-000184',
},
json={
'product_id': 110,
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | product_not_upgradeable | Das Paket ist keine Upgrade-Option für diesen Dienst (andere Familie oder niedrigeres Paket). |
| 422 | price_not_found | price_id gehört zu keinem der Abrechnungszeiträume dieses Pakets. |
| 422 | insufficient_balance | Ihr Guthaben reicht nicht aus; siehe details.required / details.available. |
| 422 | payment_failed | Die Rechnung konnte nicht aus dem Guthaben bezahlt werden; das Upgrade wurde abgebrochen. |
| 409 | upgrade_pending | Für den Dienst läuft bereits ein Upgrade; verfolgen Sie es mit GET /services/{id}/upgrade. |
| 403 | insufficient_scope | Dem 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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID |
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/upgrade');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/upgrade', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/upgrade',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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).
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID |
curl -s "https://hanhosting.com/api/v1/client/services/1204/rdns" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/rdns');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/rdns', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/rdns',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Der Dienst existiert nicht oder gehört nicht Ihnen. |
| 503 | rdns_unavailable | Der 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.
| Feld | Typ | Beschreibung |
|---|---|---|
idPflichtfeld | integer | Dienst-ID (im Pfad) |
ipPflichtfeld | string | Eine IP des Dienstes (aus GET /services/{id}/rdns) |
hostname | string | PTR-Name, z. B. mail.ornekfirma.com. Leer oder ohne Angabe wird der Standardname wiederhergestellt. |
dry_run | boolean | true: nur prüfen, den Eintrag nicht ändern |
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" }'$r = hh_api('POST', '/services/1204/rdns', [
'ip' => '176.96.128.115',
'hostname' => 'mail.ornekfirma.com',
]);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/rdns', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ "ip": "176.96.128.115", "hostname": "mail.ornekfirma.com" }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/rdns',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
json={
'ip': '176.96.128.115',
'hostname': 'mail.ornekfirma.com',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "ip": "176.96.128.115", "ptr": "mail.ornekfirma.com", "dry_run": false, "unchanged": false, "remaining_this_month": 1 } }| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | a_record_missing | Der A-Record des Namens zeigt nicht auf diese IP; details.a_records listet die gefundenen Einträge auf. |
| 422 | invalid_hostname | Ungültiger Name (Buchstaben, Ziffern, Bindestrich, Punkt; mindestens zwei Labels). |
| 404 | ip_not_owned | Die IP gehört nicht zu diesem Dienst. |
| 422 | ip_not_supported | Der Reverse DNS dieser IP kann hier nicht geändert werden. |
| 429 | monthly_limit | Das Änderungslimit für diese IP ist für diesen Monat erreicht (2 pro IP und Monat). |
| 403 | insufficient_scope | Dem 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.
| Feld | Typ | Beschreibung |
|---|---|---|
urgencyPflichtfeld | string | now (sofort) / period-ending (zum Ende des Zeitraums) |
reasonPflichtfeld | string | not-needed, too-expensive, switching, missing-features, other |
reason_detail | string | Bis zu 300 Zeichen; erforderlich bei reason=other. |
note | string | Bis zu 500 Zeichen. |
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." }'$r = hh_api('POST', '/services/1204/cancellation', [
'urgency' => 'period-ending',
'reason' => 'not-needed',
'note' => 'The customer closed the project.',
]);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/cancellation', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ "urgency": "period-ending", "reason": "not-needed", "note": "The customer closed the project." }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/cancellation',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
json={
'urgency': 'period-ending',
'reason': 'not-needed',
'note': 'The customer closed the project.',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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" }
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | not_actionable | Der Dienst ist nicht aktiv. |
| 422 | cancellation_exists | Es besteht bereits ein offener Kündigungsantrag. |
| 422 | urgency_invalid, reason_invalid, reason_detail_required | Feldwerte sind ungültig oder fehlen. |
| 422 | cancellation_rejected | Der Kündigungsantrag wurde für diesen Dienst nicht angenommen. |
| 500 | cancellation_failed | Der 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.
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"$r = hh_api('POST', '/services/1204/cancellation', null, ['X-HTTP-Method-Override: DELETE']);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/cancellation', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'X-HTTP-Method-Override': 'DELETE',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/cancellation',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
'X-HTTP-Method-Override': 'DELETE',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "revoked": true, "service_id": 1204 } }| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Es 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.
curl -s "https://hanhosting.com/api/v1/client/services/1204/dashboard" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/dashboard');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/dashboard', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/dashboard',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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": [] }
}
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | not_actionable | Der Dienst ist nicht aktiv. |
| 422 | module_unavailable | Das 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.
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/tools');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/tools', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/tools',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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": "" }
]
}| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | not_actionable | Der Dienst ist nicht aktiv. |
| 422 | tools_not_supported | Das 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.
| Feld | Typ | Beschreibung |
|---|---|---|
toolPflichtfeld | string | Tool-Schlüssel (im Pfad), z. B. email-accounts |
action | string | Leseaktion, Standard index |
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/services/1204/tools/email-accounts');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "accounts": [ { "email": "[email protected]", "quota": "1024", "used": "12.4" } ] } }| HTTP | Code | Bedeutung |
|---|---|---|
| 404 | not_found | Das Tool existiert nicht oder wird nicht unterstützt. |
| 500 | tool_data_failed | Das 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.
| Feld | Typ | Beschreibung |
|---|---|---|
toolPflichtfeld | string | Tool-Schlüssel (im Pfad) |
actionPflichtfeld | string | Aktion (im Pfad), z. B. create, delete |
… | object | Aktionsspezifische 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. |
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" }'$r = hh_api('POST', '/services/1204/tools/databases/create', [
'name' => 'magaza',
]);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/tools/databases/create', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ "name": "magaza" }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/tools/databases/create',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
json={
'name': 'magaza',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "status": "successful", "message": "Database created." } }| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | tools_not_supported, tool_rejected | Der Dienst unterstützt dieses Tool nicht, oder der Vorgang wurde abgelehnt. |
| 500 | tool_action_failed | Das 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.
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/sso" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('POST', '/services/1204/sso');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/sso', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/sso',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "url": "https://…/login?token=…" } }| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | sso_not_supported | Das Panel unterstützt keinen Login mit einem Klick. |
| 500 | sso_failed | Die 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.
| Feld | Typ | Beschreibung |
|---|---|---|
passwordPflichtfeld | string | Neues 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. |
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" }'$r = hh_api('POST', '/services/1204/password', [
'password' => 'Guclu.Parola26',
]);
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/services/1204/password', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ "password": "Guclu.Parola26" }),
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'POST',
'https://hanhosting.com/api/v1/client/services/1204/password',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
json={
'password': 'Guclu.Parola26',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){ "data": { "changed": true, "service_id": 1204 } }| HTTP | Code | Bedeutung |
|---|---|---|
| 422 | password_not_supported | Der Diensttyp unterstützt keine Passwortänderungen. |
| 422 | password_too_short | Das Passwort ist zu kurz; details.min gibt die Mindestlänge an. |
| 422 | password_change_failed | Das 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).
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.
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.
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}
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.
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.
curl -s "https://hanhosting.com/api/v1/client/me" \
-H "Authorization: Bearer $HANHOSTING_API_KEY" \
-H "Accept: application/json"$r = hh_api('GET', '/me');
print_r($r['data']);const res = await fetch('https://hanhosting.com/api/v1/client/me', {
method: 'GET',
headers: {
'Authorization': `Bearer ${process.env.HANHOSTING_API_KEY}`,
'Accept': 'application/json',
},
});
const json = await res.json();
if (!res.ok) throw new Error(`${json.error.code}: ${json.error.message}`);
console.log(json.data);import os, requests
res = requests.request(
'GET',
'https://hanhosting.com/api/v1/client/me',
headers={
'Authorization': 'Bearer ' + os.environ['HANHOSTING_API_KEY'],
'Accept': 'application/json',
},
timeout=60,
)
data = res.json()
if res.status_code >= 400:
raise RuntimeError(data['error']['code'] + ': ' + data['error']['message'])
print(data['data']){
"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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
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
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
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).
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
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": "…"}
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
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
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}
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
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
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.
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}
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
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
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
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
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
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
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
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
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
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
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
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
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
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}
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
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.
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
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
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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
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
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.
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
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
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
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
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
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
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
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-Keybei 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.
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.