Documentation de l'API
Consultez les produits et les prix, commandez avec votre solde, payez vos factures et gérez vos services depuis votre propre système. Chaque point de terminaison est accompagné d'exemples curl, PHP, Node.js et Python.
Vue d'ensemble
L'API HanHosting permet à nos revendeurs de travailler avec nous de façon automatisée depuis leurs propres systèmes : consulter les produits et les prix, passer des commandes payées avec votre solde, régler vos factures, renouveler et gérer vos services.
URL de base
https://hanhosting.com/api/v1/clientTous les points de terminaison se trouvent sous cette URL ; par exemple, la liste des services est GET https://hanhosting.com/api/v1/client/services. Il existe une seule version : v1. Les requêtes doivent être effectuées uniquement en HTTPS.
L'accès à l'API est réservé aux revendeurs. Si l'API n'est pas activée sur votre compte, vous ne verrez pas la page Identifiants API ; ouvrez un ticket d'assistance pour demander l'accès. Dans ce document, vous pouvez utiliser les points de terminaison marqués Activé ; ceux marqués Désactivé ne sont actuellement pas activés pour votre compte et renvoient 403.
Accès et clés API
Vous créez vous-même votre clé API dans votre Espace client. Une clé ne dispose que des autorisations que vous lui accordez et peut être limitée aux adresses IP de votre choix.
Indiquez-nous d'abord l'IP de votre serveur. L'API n'est accessible que depuis les adresses IP de serveurs approuvées par HanHosting, et la clé de chaque compte ne fonctionne que depuis les IP enregistrées pour ce compte. Lorsque vous demandez l'accès à l'API, envoyez dans un ticket d'assistance l'adresse IP sortante du serveur qui appellera l'API ; si votre serveur ou votre IP doit changer, envoyez la nouvelle IP à l'avance. Les requêtes provenant d'IP absentes de la liste sont refusées avec 403 ip_not_allowed.
- Ouvrez la page des clés. Espace client → Identifiants API → Créer une clé API.
- Choisissez un nom et des autorisations. Donnez à la clé un nom reconnaissable (par exemple
bayi-otomasyon) et ne cochez que les autorisations dont vous avez besoin. Les noms des autorisations sont les nomsGroup/Actionutilisés dans ce document (par exempleOrders/CreateOrder). - Restreignez les adresses IP (recommandé). Rendez la clé utilisable uniquement depuis l'adresse IP de votre serveur. Saisissez une IP par ligne ; la correspondance est exacte et les plages CIDR (telles que
/24) ne sont pas prises en charge. - Enregistrez la clé. La clé n'est affichée qu'une seule fois, au moment de sa création ; conservez-la en lieu sûr (une variable d'environnement, un coffre-fort de secrets). Si vous la perdez, Régénérer la clé vous donne une nouvelle valeur secrète ; l'ancienne valeur devient immédiatement invalide.
Les clés commencent par wck_ et comptent 36 caractères. Notre serveur ne conserve qu'un hachage (SHA-256) de la clé, pas la clé elle-même. Vous pouvez arrêter une clé avec Révoquer la clé et supprimer une clé révoquée. Chaque requête effectuée avec une clé apparaît, masquée, dans l'onglet Journaux des requêtes de la même page (30 jours, jusqu'à 500 entrées par clé).
Gardez la clé secrète. Toute personne en possession de la clé peut passer des commandes au nom de votre compte et effectuer des paiements avec votre solde, dans la limite des autorisations que vous avez accordées. Ne placez pas la clé dans du code exécuté dans le navigateur, dans une application mobile ou dans un dépôt public ; utilisez-la uniquement côté serveur.
Liste des autorisations
Les autorisations que vous pouvez sélectionner lors de la création d'une clé, et les points de terminaison qu'elles débloquent. Chaque autorisation correspond à un seul point de terminaison ; n'accordez pas d'autorisations que votre intégration n'utilise pas.
| Autorisation | Point de terminaison | Ce qu'elle permet |
|---|---|---|
Account/GetMe | GET /me | Informations de votre compte |
Products/GetProducts | GET /products | Liste des produits |
Products/GetProductCategories | GET /products/categories | Catégories de produits |
Products/GetProduct | GET /products/{id} | Détails du produit et options de commande |
Orders/PreviewOrder | POST /orders/preview | Calculer le total de la commande (aperçu) |
Orders/CreateOrder | POST /orders | Créer et payer une commande |
Orders/GetOrders | GET /orders | Liste des commandes |
Orders/GetOrder | GET /orders/{id} | Détails de la commande |
Invoices/GetInvoices | GET /invoices | Liste des factures |
Invoices/GetInvoice | GET /invoices/{id} | Détails de la facture |
Invoices/PayInvoice | POST /invoices/{id}/pay | Payer une facture avec le solde |
Balance/GetBalance | GET /balance | Solde du compte |
Balance/GetBalanceTransactions | GET /balance/transactions | Transactions du solde |
Services/GetServices | GET /services | Liste des services |
Services/GetService | GET /services/{id} | Détails du service et informations d'accès |
Services/RenewService | POST /services/{id}/renew | Créer une facture de renouvellement |
Services/GetServiceInvoices | GET /services/{id}/invoices | Factures du service |
Services/GetServiceAddons | GET /services/{id}/addons | Add-ons du service |
Services/CreateCancellation | POST /services/{id}/cancellation | Créer une demande de résiliation |
Services/RevokeCancellation | DELETE /services/{id}/cancellation | Retirer une demande de résiliation |
Services/GetServiceDashboard | GET /services/{id}/dashboard | Résumé du panneau du service |
Services/GetServiceTools | GET /services/{id}/tools | Outils du service |
Services/GetServiceToolData | GET /services/{id}/tools/{tool} | Lire les données d'un outil |
Services/RunServiceToolAction | POST /services/{id}/tools/{tool}/{action} | Exécuter une action d'outil |
Services/GetServiceSso | POST /services/{id}/sso | URL de connexion en un clic au panneau |
Services/ChangeServicePassword | POST /services/{id}/password | Changer le mot de passe du service |
26 autorisations sont actuellement activées pour votre compte. Les points de terminaison /ping, /whoami et /reference/* ne nécessitent aucune autorisation. Les points de terminaison absents de cette liste (domaines, tickets d'assistance, SMS, adresses, affiliation...) sont actuellement désactivés.
Authentification
Envoyez la clé dans l'en-tête Authorization sous forme de jeton Bearer avec chaque requête :
Authorization: Bearer wck_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXCertaines configurations de serveur ne transmettent pas l'en-tête Authorization à l'application. Dans ce cas, vous pouvez envoyer la même clé dans l'en-tête X-Api-Key.
Tester la connexion
GET /ping ne nécessite aucune authentification ; il indique que vous pouvez joindre l'API. GET /whoami indique si votre clé est valide et quelles autorisations elle porte.
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']);Format des requêtes et des réponses
Requêtes
- Pour les points de terminaison GET, envoyez les filtres dans la chaîne de requête :
/services?status=active&page=2. - Pour les points de terminaison POST / PUT / PATCH / DELETE, envoyez le corps en JSON et ajoutez toujours
Content-Type: application/json. Sans cet en-tête, le corps est lu comme des données de formulaire ; avec l'en-tête, un JSON invalide est traité comme un corps vide. Validez votre corps avant de l'envoyer. - N'appelez pas les points de terminaison PUT / PATCH / DELETE directement avec ces méthodes ; de telles requêtes n'atteignent jamais l'API (une page HTML 404 est renvoyée). Envoyez la requête en POST et ajoutez l'en-tête
X-HTTP-Method-Override: DELETE(ouPUT,PATCH) ; les exemples de cette page sont écrits ainsi. L'en-tête n'est pris en compte que pour les requêtes POST. - Les champs de fichier (comme un fichier demandé lors de la commande) n'acceptent que le format base64 : base64 brut,
data:mime;base64,...ou{"filename": "...", "content": "..."}. Il n'est pas possible de fournir une URL.
Réponse en cas de succès
Les réponses sont renvoyées au format application/json; charset=utf-8. Les données se trouvent dans le champ data et les informations de liste dans le champ meta. Les requêtes qui créent un enregistrement renvoient HTTP 201 ; les autres requêtes réussies renvoient 200.
{
"data": [ { "id": 1204, "name": "HAN-MC-1", "status": "active" } ],
"meta": { "total": 37, "page": 1, "limit": 25, "next_page": 2 }
}Réponse d'erreur
{
"error": {
"code": "insufficient_balance",
"message": "Your balance is not enough to pay this order.",
"details": { "required": 540, "available": 120 }
}
}Dans votre programme, fondez toujours vos décisions sur le champ error.code ; message est fourni à titre informatif et peut changer. details n'est présent que lorsqu'il existe des informations complémentaires.
Montants, dates et cycles de facturation
- Les montants sont des objets monétaires :
{"amount": 180.00, "currency": "TRY"}(2 décimales). Les montants des produits, des commandes et des aperçus sont exprimés dans la devise de votre solde ; les montants des services et des factures, dans leur propre devise. - La plupart des dates sont au format
YYYY-MM-DD; les transactions du solde utilisent ISO 8601 (2026-10-01T14:20:00+03:00). S'il n'y a pas de valeur,nullest renvoyé. - Clés des cycles de facturation (cycle) :
monthly,quarterly,semiannually,annually,biennially,triennially,onetime(ainsi quehourly,daily,weeklypour les produits facturés à l'heure, à la journée ou à la semaine).pricingdansGET /products/{id}indique les cycles avec lesquels un produit est vendu.
Statuts HTTP et codes d'erreur généraux
| HTTP | Code | Signification et marche à suivre |
|---|---|---|
| 401 | missing_token | Aucune clé n'a été envoyée. Ajoutez Authorization: Bearer ... ou X-Api-Key. |
| 401 | invalid_token | La clé n'a pas été reconnue ou est mal formée. Vérifiez que vous avez copié la clé complète. |
| 401 | key_revoked | La clé a été révoquée. Créez une nouvelle clé. |
| 401 | owner_inactive | Votre compte n'est pas actif ; contactez l'assistance. |
| 403 | ip_not_allowed | La requête provient d'une IP non autorisée : votre IP ne figure pas sur la liste API de HanHosting, ou elle ne fait pas partie de la restriction IP de votre clé. Envoyez l'IP sortante de votre serveur dans un ticket d'assistance ; si vous utilisez une restriction IP sur la clé, ajoutez-la également à cet endroit. |
| 403 | account_not_allowed | Votre compte ne figure pas sur la liste des comptes ayant accès à l'API. Contactez l'assistance pour obtenir l'accès à l'API. |
| 403 | insufficient_scope | La clé ne porte pas l'autorisation requise pour ce point de terminaison. Le message indique l'autorisation manquante (par exemple Orders/CreateOrder) ; modifiez la clé et ajoutez l'autorisation. Si le point de terminaison est désactivé pour votre compte, il n'apparaît pas dans la liste des autorisations. |
| 403 | client_api_not_allowed, client_scope_revoked, surface_disabled | L'accès à l'API est désactivé pour votre compte, ou les autorisations de votre clé ne sont plus activées pour votre compte. Contactez l'assistance. |
| 403 | audience_mismatch | La clé n'a pas été créée pour cette API. Utilisez une clé créée sur la page Identifiants API de votre Espace client. |
| 400 | operation_failed | L'opération n'a pas pu aboutir ; lisez le message et, si nécessaire, transmettez-le à l'assistance. |
| 404 | endpoint_not_found, not_found | L'URL n'existe pas, ou l'enregistrement demandé (service, facture, commande...) ne vous appartient pas. |
| 405 | method_not_allowed | L'URL est correcte mais la méthode HTTP est erronée (par exemple GET au lieu de POST). |
| 409 | idempotency_in_flight | La requête précédente envoyée avec le même Idempotency-Key est encore en cours de traitement ; réessayez dans un instant avec la même clé. |
| 413 | payload_too_large | Le corps est trop volumineux (en général, de gros fichiers base64). |
| 422 | idempotency_key_invalid, idempotency_key_reuse | Idempotency-Key ne comporte pas entre 8 et 191 caractères, ou la même clé a été utilisée avec un corps différent. Voir Requêtes idempotentes. |
| 422 | validation_failed et codes propres au point de terminaison | La requête est bien formée mais enfreint une règle métier (champ manquant, solde insuffisant, cycle invalide...). Les codes sont indiqués dans la description de chaque point de terminaison. |
| 429 | rate_limited | La limite de requêtes par minute a été dépassée. Attendez le délai indiqué dans Retry-After. |
| 429 | abuse_lockout, too_many_auth_failures | Verrouillage temporaire (15 minutes) en raison d'une charge excessive ou d'un trop grand nombre d'échecs d'authentification. |
| 500 | server_error et codes propres au point de terminaison | Erreur inattendue, ou le panneau connecté (serveur, licence, etc.) a rejeté la requête. Consignez le message ; si une nouvelle tentative ne résout pas le problème, transmettez-le à l'assistance. |
Limites de débit et protection
- La limite par défaut par clé est de 60 requêtes par minute ; la limite actuelle de votre clé est indiquée dans l'en-tête
X-RateLimit-Limit. La fenêtre d'une minute est fixe ; le compteur est remis à zéro au début de chaque nouvelle minute. - Chaque réponse authentifiée contient des en-têtes indiquant votre quota restant (ils ne sont pas envoyés sur
/pingni en cas d'erreur d'authentification) :X-RateLimit-Limit,X-RateLimit-Remaining,X-RateLimit-Reset(fin de la fenêtre, sous forme d'horodatage Unix). Dans une réponse 429,Retry-Aftervous indique combien de secondes attendre. - Une clé qui envoie plus de 5 fois sa limite en une minute est verrouillée pendant 15 minutes (
abuse_lockout). - De nombreuses tentatives de clé échouées depuis la même IP en 5 minutes bloquent cette IP pendant 15 minutes (
too_many_auth_failures). - Les requêtes rejetées comptent également dans la limite. Au lieu de parcourir fréquemment la liste des services, interrogez les enregistrements qui changent et mettez brièvement les résultats en cache.
Pagination, recherche et tri
- Les points de terminaison de liste acceptent
page(commence à 1) etlimit(1–100, 25 par défaut). - Le champ
metade la réponse :total(nombre total d'enregistrements),page,limit,next_page(0sur la dernière page). searchrecherche dans des champs tels que le nom, le domaine ou le numéro de facture, selon le point de terminaison.- L'ordre des listes est fixe (les enregistrements importants en premier) ; seule la liste des factures peut être triée, avec
sortetdir.
$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);Requêtes idempotentes (Idempotency-Key)
En cas de coupure réseau, vous ne savez pas forcément si une requête de commande est bien passée. Ajoutez un en-tête Idempotency-Key aux requêtes POST qui entraînent un mouvement d'argent (POST /orders, POST /invoices/{id}/pay, POST /services/{id}/renew) ; une requête que vous répétez avec la même clé n'est pas traitée une seconde fois, et la réponse d'origine est renvoyée telle quelle.
- L'en-tête n'est pris en compte que pour les requêtes POST. La clé compte de 8 à 191 caractères (sinon 422
idempotency_key_invalid) ; générez une valeur unique pour chaque nouvelle opération (par exemple votre propre numéro de commande ou un UUID). - La réponse est conservée pendant 24 heures. Une réponse rejouée contient l'en-tête
Idempotency-Replayed: true. - Si vous utilisez la même clé avec un corps différent, vous obtenez 422
idempotency_key_reuse; le corps doit être identique à l'octet près. - Si la première requête est encore en cours de traitement, 409
idempotency_in_flightest renvoyé ; patientez un instant et réessayez avec la même clé. Un verrou d'opération resté bloqué est libéré au bout de 10 minutes.
Les réponses d'erreur sont conservées elles aussi. Si la première requête a renvoyé une erreur 4xx (par exemple 422 insufficient_balance), les nouvelles tentatives avec la même clé renvoient la même erreur pendant 24 heures. Après avoir corrigé le problème (par exemple en alimentant votre solde), envoyez la requête avec une nouvelle clé. Seule une erreur 500 server_error libère la clé.
Idempotency-Key: bayi-siparis-2026-000184Scénario : commande automatique avec votre solde
Le flux recommandé pour nous acheter automatiquement la même offre lorsque votre client vous achète une offre :
- Consultez le produit et ses options :
GET /products/{id}.pricingindique les cycles proposés,requirementsetaddonsles choix que vous devez envoyer avec la commande, etdomain.modesi un domaine est nécessaire. - Vérifiez votre solde :
GET /balance. - Calculez le total :
POST /orders/previewrenvoie le total, coupons et taxes compris, sans créer de commande. - Créez la commande :
POST /orders+"payment": {"method": "balance"}+Idempotency-Key. Si votre solde est suffisant, la facture est payée en même temps et le service entre dans la file de mise en service. - Suivez la mise en service : récupérez l'ID du service dans
services[]deGET /orders/{id}; dès queGET /services/{id}indique le statutactive, transmettez les informations d'accès (access) à votre client.
$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'];Moyen de paiement : les paiements via l'API sont effectués avec le solde de votre compte. Alimentez votre solde depuis l'Espace client (Solde du compte → Alimenter le solde). Les commandes d'un total de 0 ne nécessitent aucun paiement. Si votre solde est insuffisant, la commande n'est pas créée du tout et 422 insufficient_balance est renvoyé.
Scénario : renouvellement de service et paiement de facture
GET /services/{id}→ consultez les cycles renouvelables avecrenewal.availableetrenewal.cycles. Si le service a une facture ouverte,renewal.open_invoice_idest renseigné.POST /services/{id}/renew(éventuellement{"cycle": "annually"}) → une facture de renouvellement est émise ; aucun paiement n'est effectué. Si la même période est déjà facturée, la facture existante est renvoyée avecexisting: true.POST /invoices/{invoice_id}/pay+{"payment": {"method": "balance"}}→ la facture est payée avec votre solde et la durée du service est prolongée.
Pour trouver les services qui arrivent à échéance, utilisez le champ due_date dans le résultat de GET /services?status=active. Pour les factures impayées, effectuez deux requêtes : GET /invoices?status=unpaid (pas encore échues) et GET /invoices?status=overdue (échues).
Scénario : gestion des services (connexion au panneau, mot de passe, outils)
- Connexion en un clic au panneau :
POST /services/{id}/ssorenvoie une URL qui ouvre une session sur le panneau de gestion du service (cPanel, panel de jeu, etc.). L'URL a une durée de vie courte ; redirigez immédiatement le client et ne la stockez pas. - Changement de mot de passe :
POST /services/{id}/password(services d'hébergement et de serveur). - Résumé et utilisation des ressources :
GET /services/{id}/dashboardrenvoie le nom du panneau, les actions disponibles et les jauges de ressources. - Outils du service :
GET /services/{id}/toolsliste les outils disponibles pour votre service et les actions de chaque outil (capabilities). UtilisezGET /services/{id}/tools/{tool}pour lire des données etPOST /services/{id}/tools/{tool}/{action}pour effectuer des opérations. Les outils varient selon le panneau auquel le service est connecté ; par exemple, l'hébergement web dispose d'outils pour les comptes e-mail, les bases de données, les enregistrements DNS et les tâches cron.
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!"}'Les actions d'outil apportent des modifications réelles sur le panneau et sont consignées dans l'historique du service. Les opérations rejetées par le panneau renvoient HTTP 500 tool_action_failed avec le message du panneau.
Scénario : console VNC sur les serveurs VDS
Sur les services VDS (serveur virtuel), vous pouvez accéder à l'écran de la machine via la console VNC, même lorsque la connexion réseau ou RDP/SSH ne fonctionne pas. Elle repose sur la même infrastructure que la Console de notre Espace client ; avec l'URL obtenue via l'API, vous pouvez l'intégrer à votre propre panneau. Son utilisation est facultative ; elle s'adresse aux revendeurs qui en ont besoin.
- Consultez l'état de la machine :
GET /services/{id}/tools/vnc-console. Le champpowerrenvoierunning,stopped,installingoususpended. Si la machine est éteinte, démarrez-la d'abord avecPOST /services/{id}/tools/start-server/execute; si une installation est en cours, attendez qu'elle se termine. - Obtenez une URL de connexion :
POST /services/{id}/tools/vnc-console/create(aucun corps de requête nécessaire). Le champdata.urlde la réponse est une URL à usage unique de la formewss://console.hanhosting.com/…/beconsole/…. - Connectez-vous : transmettez immédiatement l'URL à un client VNC (RFB), dans un délai de 3 minutes ; par exemple, noVNC dans le navigateur. L'URL ne peut être utilisée qu'une seule fois ; obtenez une nouvelle URL pour chaque nouvelle connexion.
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);
}Limites et cas d'erreur
- La console ne s'ouvre que pour les services actifs.
- Par service, au moins 3 secondes doivent s'écouler entre deux URL, et pas plus de 15 par tranche de 10 minutes peuvent être obtenues. En cas de dépassement, 500
tool_action_failedest renvoyé avec le message « Trop de demandes de console en peu de temps… ». - Si aucune URL ne peut être obtenue (par exemple parce que la machine est éteinte), 500
tool_action_failedest renvoyé avec le message « Impossible d'ouvrir une connexion à la console… » ; démarrez la machine et réessayez. - Le point de terminaison de connexion à la console accepte 30 requêtes par minute et par IP. La limite propre à votre clé API (60 requêtes par minute) s'applique également.
- Lorsque la console est ouverte depuis une adresse IP inconnue au cours des 30 derniers jours, un e-mail de notification est envoyé à votre compte. Lorsqu'elle est ouverte via l'API, cette IP est l'adresse de votre serveur qui effectue la requête.
Disposition du clavier : le champ kbd_default indique la disposition attendue par la machine : tr (turc Q) sur les modèles Windows, us sur les autres. La console envoie les touches selon la disposition américaine (US) ; lorsque vous tapez depuis votre propre client sur une machine Windows en turc Q, la touche i peut par exemple arriver sous la forme ı, soyez donc attentif lors de la saisie des mots de passe. La console de notre Espace client effectue elle-même cette conversion.
Les sessions RDP ne sont pas visibles sur l'écran VNC ; la console affiche l'écran propre de la machine.
Référence des points de terminaison
Vous pouvez utiliser 31 des 112 points de terminaison au total. Cliquez sur un point de terminaison pour afficher ses paramètres, des exemples curl / PHP / Node.js / Python, un exemple de réponse et les erreurs possibles.
Les ID, prix et dates des exemples sont donnés à titre indicatif ; appelez les points de terminaison concernés pour obtenir les valeurs actuelles. Les exemples PHP utilisent la fonction utilitaire hh_api() de la section Authentification.
Système et données de référence
Test de connexion, informations sur la clé et listes pays / province / district utilisées dans les formulaires d'adresse. Ces points de terminaison ne demandent aucune autorisation distincte ; tous, sauf /ping, exigent une clé valide. 5 / 5 activés
GET/pingTest de connexion Aucune autorisation requise
Aucune clé requise. Indique si vous pouvez joindre l'API. 120 requêtes par minute et par 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/whoamiInformations sur la clé Aucune autorisation requise
Peut être appelé avec n'importe quelle clé valide (aucune autorisation distincte requise). Renvoie le nom de la clé, les autorisations qu'elle porte et la date et l'heure de sa précédente utilisation.
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/countriesListe des pays Aucune autorisation requise
Codes (ISO-2) et noms des pays. Utilisés dans les champs d'adresse et d'informations de facturation.
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}/statesProvinces d'un pays Aucune autorisation requise
| Champ | Type | Description |
|---|---|---|
codeobligatoire | chaîne | Code du pays (ISO-2), p. ex. 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 | Signification |
|---|---|---|
| 404 | not_found | Code de pays introuvable. |
GET/reference/states/{id}/citiesDistricts d'une province Aucune autorisation requise
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID de la province (issu de la réponse 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 | Signification |
|---|---|---|
| 404 | not_found | Province introuvable. |
Produits
Produits en vente, catégories, prix par cycle de facturation et options de commande. 3 / 3 activés
GET/productsListe des produits Activé
Produits en vente (actifs et visibles), état du stock et prix par cycle de facturation. Les prix sont exprimés dans la devise de votre solde.
| Champ | Type | Description |
|---|---|---|
type | chaîne | Type de produit : hosting, server, software, special ... Un type invalide renvoie 422 type_invalid ainsi que les types autorisés. |
category | entier | ID de la catégorie (GetProductCategories). |
search | chaîne | Recherche dans les noms de produit. |
page, limit | entier | Pagination (limit 1–100, 25 par défaut). |
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/categoriesCatégories de produits Activé
| Champ | Type | Description |
|---|---|---|
type | chaîne | Uniquement les catégories de ce type. |
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}Détails du produit et options de commande Activé
À lire systématiquement avant de commander : les cycles de facturation proposés (pricing), les add-ons (addons), les choix demandés lors de la commande (requirements), la règle de quantité et la nécessité ou non d'un domaine (domain).
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du produit |
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 | Signification |
|---|---|---|
| 404 | not_found | Le produit n'est pas en vente, est masqué ou n'existe pas. |
requirements / addons : lors de la commande, vous envoyez {"<requirement id>": "<option id>"} dans le champ requirements et {"<addon id>": <option id>} dans le champ addons. Le champ price d'une option d'add-on peut valoir null pour les options gratuites. Envoyez aussi dans votre commande API les choix marqués d'un astérisque (*) sur la page de commande de notre site.
domain.mode : none signifie qu'aucun domaine n'est nécessaire ; chooser exige domain dans l'élément de commande (votre propre domaine ou un sous-domaine) ; license exige un domaine ou une IP de licence. Les nouveaux enregistrements de domaine se font avec les points de terminaison des domaines, pas avec celui-ci.
Commandes
Aperçu du prix, commande avec le solde et commandes enregistrées. 4 / 4 activés
POST/orders/previewCalculer le total de la commande (aperçu) Activé
Calcule le total, y compris la première période au prorata, les add-ons, les frais d'installation, les coupons et la taxe, sans créer de commande. Ne crée aucun enregistrement et ne modifie pas votre solde.
| Champ | Type | Description |
|---|---|---|
itemsobligatoire | tableau | Éléments de commande ; même structure que pour POST /orders. |
coupons | tableau | Codes de coupon. |
billing_profile_id | entier | Adresse de facturation enregistrée (détermine le taux de taxe). |
payment | objet | {"method": "balance"} ; sert uniquement à inclure les frais du moyen de paiement (fee) dans le calcul. |
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 | Signification |
|---|---|---|
| 422 | … | Les erreurs d'élément (produit, cycle, choix de commande, add-on, domaine, coupon) sont les mêmes que pour POST /orders. |
unit_price est le prix pour une période complète ; total comprend le montant au prorata de la première période, les add-ons et les frais d'installation. L'aperçu ne vérifie pas l'acceptation des conditions, les restrictions du compte ni votre solde ; ces contrôles n'ont lieu que lors de POST /orders.
POST/ordersCréer et payer une commande Activé
Crée la commande, sa facture et les enregistrements de service, puis règle la facture avec votre solde. Une fois le paiement effectué, le service entre dans la file d'attente de mise en service automatique.
| Champ | Type | Description |
|---|---|---|
termsobligatoire | booléen | Acceptation du contrat de services : doit être le booléen JSON true ; sinon, 422 terms_required. |
itemsobligatoire | tableau | Jusqu'à 20 éléments. Les champs d'un élément sont détaillés ci-dessous. |
items[].product_idobligatoire | entier | ID du produit (doit être en vente). |
items[].cycleobligatoire | chaîne | Clé du cycle de facturation ; l'une de celles de la liste pricing du produit. |
items[].quantity | entier | 1 par défaut. Si le produit ne permet pas de choisir une quantité, la valeur 1 est retenue. |
items[].requirements | objet | Choix de commande : {"3": "1", "5": "1"}. Un ID d'option pour les champs à choix, un tableau d'ID pour les cases à cocher, du texte pour les champs de texte. |
items[].requirement_files | objet | Choix de commande qui demandent un fichier : {"<id>": "base64 or data-URI"}. |
items[].addons | objet | Add-ons : {"11": 0} (ID de l'add-on → ID de l'option). N'envoyez pas du tout la clé d'un add-on dont vous ne voulez pas. |
items[].addons_qty | objet | Quantité pour les add-ons vendus à l'unité : {"11": 2}. |
items[].metrics | tableau | ID des métriques, pour activer les métriques facturées à l'usage. |
items[].domain | objet | Pour les produits avec domain.mode=chooser : {"option": "owned", "name": "ornekfirma.com"} ou {"option": "subdomain", "base": "…", "name": "etiket"}. Pour les produits de licence : {"license_domain": "…"} ou {"license_ip": "…"}. |
paymentobligatoire | objet | {"method": "balance"}. Non requis si le total est 0. |
coupons | tableau | Codes de coupon. |
billing_profile_id | entier | Adresse de facturation enregistrée ; si elle est omise, l'adresse du compte est utilisée. |
notes | chaîne | Note de commande (1000 caractères maximum). |
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 | Signification |
|---|---|---|
| 422 | terms_required | terms n'a pas été envoyé avec la valeur true. |
| 422 | items_required, items_invalid, too_many_items | Aucun élément, liste mal formée ou plus de 20 éléments. |
| 422 | item_invalid, product_required | Un élément n'est pas un objet, ou product_id est absent. |
| 422 | product_not_orderable | Le produit n'est pas en vente. |
| 422 | cycle_invalid | Ce produit ne propose pas ce cycle ; details.allowed liste les cycles valides. |
| 422 | item_unpriced | Aucun prix n'est défini pour ce cycle. |
| 422 | out_of_stock, order_limit_reached | Rupture de stock, ou la limite de commande du produit est atteinte. |
| 422 | addon_invalid, addon_option_invalid | L'add-on n'appartient pas à ce produit, ou l'option n'existe pas. |
| 422 | requirement_missing | Un choix obligatoire n'a pas été envoyé. |
| 422 | file_url_not_allowed, file_upload_failed | Une URL a été fournie pour un champ de fichier, ou le fichier base64 n'a pas pu être enregistré. |
| 422 | metric_invalid | La métrique n'appartient pas à ce produit. |
| 422 | domain_required, domain_invalid, subdomain_invalid, subdomain_base_invalid | Le choix de domaine est absent ou invalide. |
| 422 | license_domain_required, license_ip_required | Aucun domaine ni aucune IP n'a été envoyé pour un produit de licence. |
| 422 | domain_acquisition_not_here | Les nouveaux enregistrements et transferts de domaine ne peuvent pas être effectués avec ce point de terminaison. |
| 422 | coupon_invalid | Le coupon est invalide ou ne peut pas être appliqué à cette commande. |
| 422 | payment_method_invalid, payment_method_unavailable | Le moyen de paiement est absent, invalide ou indisponible. Envoyez balance. |
| 422 | insufficient_balance | Solde insuffisant ; la commande n'est pas créée. details.required et details.available (nombres) sont renvoyés. |
| 422 | account_restricted, checkout_blocked | Votre compte n'est pas autorisé à passer des commandes. |
| 404 | not_found | L'adresse de facturation indiquée dans billing_profile_id est introuvable. |
Effets de bord : les enregistrements de commande, de facture et de service sont créés ; si votre solde est suffisant, la facture passe immédiatement à paid et la mise en service démarre. Si payment.status vaut failed (la raison figure dans le champ payment.error), la commande et la facture sont conservées ; vous pouvez alimenter votre solde et payer avec POST /invoices/{id}/pay. Pour une commande dont le total est 0, le champ payment renvoie {"method": "free", "status": "paid"}.
Offres de serveur de jeu : ces offres exigent le choix Type d'installation : Panel de jeu ou Serveur VDS. Si vous choisissez VDS, envoyez aussi le choix Système d'exploitation ; les add-ons VDS (RAM, CPU, disque, IP supplémentaires, protection DDoS) ne s'appliquent qu'à une installation VDS. Les ID tels que "3", "5", "11" dans les exemples sont donnés à titre indicatif ; lisez toujours les ID réels des choix de commande, de leurs options et des add-ons dans la réponse de GET /products/{id}.
GET/ordersListe des commandes Activé
Vos commandes, des plus récentes aux plus anciennes.
| Champ | Type | Description |
|---|---|---|
page, limit | entier | Pagination. |
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}Détails de la commande Activé
Les lignes de la commande, les services créés par la commande (services[]) et un récapitulatif de facture. Après la commande, récupérez ici l'ID du service.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID de la commande |
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 | Signification |
|---|---|---|
| 404 | not_found | La commande n'existe pas ou ne vous appartient pas. |
Factures
Liste des factures, détails d'une facture et paiement avec le solde. 3 / 4 activés
GET/invoicesListe des factures Activé
Ordre par défaut : en retard, ouvertes, payées, remboursées, annulées.
| Champ | Type | Description |
|---|---|---|
status | chaîne | paid, unpaid, overdue, refunded, cancelled, waiting. |
search | chaîne | Numéro de facture ou description de la première ligne de facture. |
sort | chaîne | created, due, price |
dir | chaîne | asc / desc (desc par défaut) |
page, limit | entier | Pagination. |
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 | Signification |
|---|---|---|
| 422 | status_invalid | Valeur de statut invalide. |
status est le statut brut ; state indique overdue pour les factures impayées dont l'échéance est dépassée. Remarque : le filtre status=unpaid n'inclut pas les factures en retard ; pour obtenir toutes les factures impayées, effectuez deux requêtes distinctes avec unpaid et overdue.
GET/invoices/{id}Détails de la facture Activé
Lignes de facture, détail des taxes et des remises, montant dû (amount_due), possibilité de paiement (payable), informations de facturation et transactions de paiement.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID de la facture |
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 | Signification |
|---|---|---|
| 404 | not_found | La facture n'existe pas ou ne vous appartient pas. |
La réponse contient aussi les champs informations de facturation (billed_to), notes, custom_fields, coordonnées pour le virement bancaire (bank_transfer) et subscription_locked ; parent_item_id, event, domain, tax_exempt, additional_taxes sur les lignes de facture ; et discounts (reseller, coupon), payment_fee et installment dans summary. Sur une facture exonérée de taxe, summary.tax vaut null.
POST/invoices/{id}/payPayer une facture avec le solde Activé
Règle une facture impayée avec le solde de votre compte. S'il s'agit d'une facture de renouvellement, la durée du service est prolongée.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID de la facture (dans le chemin) |
payment.methodobligatoire | chaîne | 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 | Signification |
|---|---|---|
| 422 | invoice_not_payable | La facture n'est pas impayée, ou elle n'a aucun montant dû. |
| 422 | subscription_collects | Cette facture est réglée par un abonnement. |
| 422 | balance_not_allowed | Une facture d'alimentation du solde ne peut pas être payée avec le solde. |
| 422 | payment_method_invalid, payment_method_unavailable | Le moyen de paiement est absent, invalide ou indisponible. Envoyez balance. |
| 422 | payment_rejected | Le paiement a été refusé. |
| 422 | insufficient_balance | Votre solde ne couvre pas le montant dû (frais éventuels compris). |
| 429 | invoice_payment_in_progress | La même facture est en cours de paiement par une autre requête. |
| 500 | wallet_charge_failed | Le débit de votre solde n'a pas pu être effectué ; réessayez et contactez l'assistance si le problème persiste. |
POST/invoices/{id}/couponAppliquer un coupon à une facture Désactivé
Applique un coupon de réduction à une facture impayée avec {"code": "KUPON"}.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Solde du compte
Solde actuel et transactions du solde. 2 / 3 activés
GET/balanceSolde du compte Activé
Solde actuel, alerte de solde bas et paramètres du paiement automatique par le solde.
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/transactionsTransactions du solde Activé
| Champ | Type | Description |
|---|---|---|
type | chaîne | up (alimentation) / down (dépense) |
search | chaîne | Recherche dans les descriptions. |
page, limit | entier | Pagination. |
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 | Signification |
|---|---|---|
| 422 | type_invalid | Type invalide. |
PATCH/balance/settingsParamètres du solde Désactivé
Paramètres du paiement automatique par le solde, de la carte de secours et de l'alerte de solde bas.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Services
Liste et détails des services, renouvellement, upgrades d'offre, DNS inverse (rDNS), demandes de résiliation, connexion au panneau de gestion, mot de passe et outils du service. 18 / 23 activés
GET/servicesListe des services Activé
Tous vos services, sauf les domaines. Ordre : services actifs en retard, en attente, suspendus, actifs, expirés.
| Champ | Type | Description |
|---|---|---|
status | chaîne | active, pending, suspended, expired, cancelled |
type | chaîne | hosting, server, software, special |
search | chaîne | Recherche dans le nom, le domaine ou le nom du serveur. |
page, limit | entier | Pagination. |
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}Détails du service et informations d'accès Activé
Statut, prix et date d'échéance, informations d'accès (access), options de renouvellement (renewal) et, le cas échéant, la demande de résiliation (cancellation).
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service |
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 | Signification |
|---|---|---|
| 404 | not_found | Le service n'existe pas, ne vous appartient pas ou son accès est restreint. |
Selon le type de service, access peut contenir les clés suivantes : domain, hostname, ip, assigned_ips, username, password, server, nameservers ; ainsi que license_key et license_parameters pour les services de licence. Les clés vides sont entièrement omises de la réponse. access.password est renvoyé en clair ; conservez-le en lieu sûr. S'il n'y a pas de facture ouverte, renewal.open_invoice_id vaut 0.
POST/services/{id}/renewCréer une facture de renouvellement Activé
Émet une facture de renouvellement pour le service ; cette opération n'effectue aucun paiement. Pour payer, utilisez POST /invoices/{id}/pay.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service (dans le chemin) |
cycle | chaîne | Cycle de renouvellement ; l'un de ceux de renewal.cycles. S'il est omis, le cycle actuel est utilisé. |
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 | Signification |
|---|---|---|
| 422 | cycle_invalid | Ce cycle n'est pas proposé pour le renouvellement. |
| 422 | not_renewable | Le service n'est pas au statut actif, expiré ou annulé. |
| 422 | already_invoiced | Cette période a déjà été facturée. |
| 422 | renew_blocked_subscription | Le service est renouvelé par un abonnement. |
| 422 | renew_disabled, renew_rejected | Aucune facture de renouvellement ne peut être émise pour ce service. |
| 422 | account_restricted | Votre compte n'est pas autorisé à effectuer des renouvellements. |
| 500 | renew_failed | La facture n'a pas pu être créée (p. ex. service ponctuel). |
Si la même période est déjà facturée et que le service a une facture ouverte, aucune nouvelle facture n'est émise ; la facture existante est renvoyée avec HTTP 200 et "existing": true. Une nouvelle facture renvoie HTTP 201.
GET/services/{id}/invoicesFactures du service Activé
| Champ | Type | Description |
|---|---|---|
limit | entier | 1–100, 25 par défaut |
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 du service Activé
Add-ons en attente, actifs et suspendus (RAM supplémentaire, adresse IP supplémentaire, etc.).
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-optionsOptions d'upgrade Activé
Toutes les offres supérieures vers lesquelles le service peut passer (même famille, p. ex. HAN-R9-2 … HAN-R9-12 pour HAN-R9-1) et le montant à payer pour chaque cycle de facturation. difference est la différence de prix pour les jours restants ; reseller_discount est votre remise revendeur et payable_total est le montant, TVA comprise, débité de votre solde. Les offres intermédiaires peuvent être sautées.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service |
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 | Signification |
|---|---|---|
| 404 | not_found | Le service n'existe pas ou ne vous appartient pas. |
| 422 | service_not_active | Seuls les services actifs peuvent faire l'objet d'un upgrade. |
| 403 | upgrades_disabled | Les upgrades sont désactivés pour ce type de service. |
| 403 | insufficient_scope | La clé ne dispose pas de l'autorisation Services/GetService. |
Une liste vide signifie que le service est déjà sur l'offre la plus élevée de sa famille. Les downgrades ne sont pas proposés. Les montants dépendent des jours restants au moment de la requête ; interrogez de nouveau l'API juste avant l'achat.
POST/services/{id}/upgradeUpgrade de l'offre Activé
Effectue l'upgrade du service vers l'offre supérieure choisie : une facture de différence est émise et payée avec votre solde (remise revendeur appliquée), puis les ressources sont augmentées automatiquement. Le serveur redémarre pendant 1 à 2 minutes. dry_run: true renvoie le montant et indique si votre solde le couvre, sans rien créer.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service (dans le chemin) |
product_idobligatoire | entier | Offre cible, issue de la liste upgrade-options |
price_id | entier | Cycle de facturation ; s'il est omis, le cycle actuel du service (p. ex. mensuel) |
pay_with_balance | booléen | Par défaut true. Avec false, la facture reste impayée ; l'upgrade démarre dès qu'elle est payée avec POST /invoices/{id}/pay. |
dry_run | booléen | true : vérification et calcul du prix uniquement ; aucun enregistrement ni aucune facture n'est créé |
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 | Signification |
|---|---|---|
| 422 | product_not_upgradeable | L'offre n'est pas une option d'upgrade pour ce service (autre famille ou offre inférieure). |
| 422 | price_not_found | price_id ne fait pas partie des cycles de facturation de cette offre. |
| 422 | insufficient_balance | Votre solde ne suffit pas ; voir details.required / details.available. |
| 422 | payment_failed | La facture n'a pas pu être payée avec le solde ; l'upgrade a été annulé. |
| 409 | upgrade_pending | Le service a déjà un upgrade en cours ; suivez-le avec GET /services/{id}/upgrade. |
| 403 | insufficient_scope | La clé ne dispose pas de l'autorisation Invoices/PayInvoice. |
À l'arrivée de la réponse, le paiement a déjà été prélevé ; l'augmentation des ressources se termine en quelques minutes (upgrade.status : inprocess → completed). Sur les serveurs Windows, si le disque C n'est pas étendu automatiquement, étendez-le dans « Disk Management » (Gestion des disques).
GET/services/{id}/upgradeStatut de l'upgrade Activé
État du dernier upgrade du service : inprocess (en cours), completed, cancelled. S'il n'y en a aucun, upgrade: null.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service |
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}/rdnsEnregistrements DNS inverse (rDNS) Activé
Les IP du service dont le DNS inverse peut être géré, avec le nom PTR actuel et le nom par défaut de chacune. Pour le moment, ce sont les adresses 176.96.128.x qui peuvent être gérées. remaining_this_month indique les modifications restantes ce mois-ci : par IP sur chaque ligne, et le total pour toutes les IP du service au niveau supérieur (2 par IP et par mois).
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service |
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 | Signification |
|---|---|---|
| 404 | not_found | Le service n'existe pas ou ne vous appartient pas. |
| 503 | rdns_unavailable | Le service de DNS inverse ne répond temporairement pas ; réessayez dans un instant. |
POST/services/{id}/rdnsDéfinir le DNS inverse (rDNS) Activé
Définit le nom PTR de l'IP ou (si hostname est vide) rétablit le nom par défaut. Le nom doit être confirmé en résolution directe : créez d'abord pour ce nom un enregistrement A qui pointe vers l'IP. Au maximum 2 modifications par IP et par mois ; le rétablissement du nom par défaut compte aussi. Si le nom est déjà défini, rien n'est modifié et aucune modification n'est décomptée. dry_run: true effectue uniquement la vérification.
| Champ | Type | Description |
|---|---|---|
idobligatoire | entier | ID du service (dans le chemin) |
ipobligatoire | chaîne | Une IP du service (issue de GET /services/{id}/rdns) |
hostname | chaîne | Nom PTR, p. ex. mail.ornekfirma.com. Vide ou omis : le nom par défaut est rétabli. |
dry_run | booléen | true : vérification uniquement, sans modifier l'enregistrement |
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 | Signification |
|---|---|---|
| 422 | a_record_missing | L'enregistrement A du nom ne pointe pas vers cette IP ; details.a_records liste les enregistrements trouvés. |
| 422 | invalid_hostname | Nom invalide (lettres, chiffres, trait d'union, point ; au moins deux labels). |
| 404 | ip_not_owned | L'IP n'appartient pas au service. |
| 422 | ip_not_supported | Le DNS inverse de cette IP ne peut pas être modifié ici. |
| 429 | monthly_limit | La limite de modifications de cette IP est atteinte pour ce mois-ci (2 par IP et par mois). |
| 403 | insufficient_scope | La clé ne dispose pas de l'autorisation Services/RunServiceToolAction. |
La modification est inscrite immédiatement sur les serveurs de noms primaire et secondaire ; les caches DNS publics peuvent mettre quelques minutes à l'afficher. Si le service est supprimé ou si l'IP passe à un autre service, le nom personnalisé est automatiquement remis à la valeur par défaut.
POST/services/{id}/cancellationCréer une demande de résiliation Activé
Ouvre une demande de résiliation pour un service actif. Notre équipe traite la demande ; le service n'est pas arrêté immédiatement.
| Champ | Type | Description |
|---|---|---|
urgencyobligatoire | chaîne | now (immédiatement) / period-ending (à la fin de la période) |
reasonobligatoire | chaîne | not-needed, too-expensive, switching, missing-features, other |
reason_detail | chaîne | 300 caractères maximum ; obligatoire si reason=other. |
note | chaîne | 500 caractères maximum. |
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 | Signification |
|---|---|---|
| 422 | not_actionable | Le service n'est pas actif. |
| 422 | cancellation_exists | Une demande de résiliation ouverte existe déjà. |
| 422 | urgency_invalid, reason_invalid, reason_detail_required | Des valeurs de champ sont invalides ou absentes. |
| 422 | cancellation_rejected | La demande de résiliation n'a pas été acceptée pour ce service. |
| 500 | cancellation_failed | La demande n'a pas pu être enregistrée ; réessayez. |
DELETE/services/{id}/cancellationRetirer une demande de résiliation Activé
Supprime une demande de résiliation en attente ou approuvée ; aucun corps de requête n'est nécessaire.
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 | Signification |
|---|---|---|
| 404 | not_found | Il n'existe aucune demande de résiliation ouverte. |
GET/services/{id}/dashboardRésumé du panneau du service Activé
Nom du panneau connecté, prise en charge de la connexion en un clic et du changement de mot de passe, actions rapides et jauges de ressources (CPU, RAM, disque, etc.). Le service doit être actif.
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 | Signification |
|---|---|---|
| 422 | not_actionable | Le service n'est pas actif. |
| 422 | module_unavailable | Le panneau connecté au service ne prend pas en charge cette opération. |
GET/services/{id}/toolsOutils du service Activé
Les outils disponibles pour votre service et les actions prises en charge par chaque outil (capabilities). Les outils varient selon le panneau.
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 | Signification |
|---|---|---|
| 422 | not_actionable | Le service n'est pas actif. |
| 422 | tools_not_supported | Le panneau du service ne prend pas en charge les outils. |
Quelques outils de l'hébergement web (cPanel) : file-manager, ftp-accounts, databases, subdomains, addon-domains, domain-redirects, dns-zone-editor, email-accounts, email-forwarders, php-version, cron-jobs, ssl-management. Les services VDS (serveur virtuel) disposent de start-server, stop-server, restart-server, reset-password, reinstall-os et vnc-console ; pour la console VNC, consultez le scénario Console VNC d'un VDS. Appelez toujours ce point de terminaison pour obtenir la liste à jour.
GET/services/{id}/tools/{tool}Lire les données d'un outil Activé
Renvoie les données de l'outil (p. ex. la liste des comptes e-mail). Les paramètres de requête supplémentaires sont transmis à l'outil.
| Champ | Type | Description |
|---|---|---|
toolobligatoire | chaîne | Clé de l'outil (dans le chemin), p. ex. email-accounts |
action | chaîne | Action de lecture, index par défaut |
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 | Signification |
|---|---|---|
| 404 | not_found | L'outil n'existe pas ou n'est pas pris en charge. |
| 500 | tool_data_failed | Le panneau n'a pas pu renvoyer les données (p. ex. l'outil est désactivé). |
La structure de la réponse varie selon l'outil et le panneau.
POST/services/{id}/tools/{tool}/{action}Exécuter une action d'outil Activé
Exécute l'une des actions de l'outil (création, suppression, modification…). Les champs du corps de la requête dépendent de l'outil et de l'action ; l'action doit figurer dans la liste capabilities de l'outil.
| Champ | Type | Description |
|---|---|---|
toolobligatoire | chaîne | Clé de l'outil (dans le chemin) |
actionobligatoire | chaîne | Action (dans le chemin), p. ex. create, delete |
… | objet | Champs propres à l'action. Exemples : 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 | Signification |
|---|---|---|
| 422 | tools_not_supported, tool_rejected | Le service ne prend pas en charge cet outil, ou l'opération a été refusée. |
| 500 | tool_action_failed | Le panneau a refusé l'opération : champ manquant, action non prise en charge ou erreur du panneau. message contient le message du panneau. |
L'opération apporte de réelles modifications sur le panneau et est consignée dans l'historique du service. Exemple VDS : POST /services/{id}/tools/start-server/execute démarre la machine et POST /services/{id}/tools/vnc-console/create renvoie une URL de console VNC à usage unique (détails).
POST/services/{id}/ssoURL de connexion en un clic au panneau Activé
Génère une URL à courte durée de validité qui ouvre une session sur le panneau de gestion du service. Aucun corps de requête n'est nécessaire.
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 | Signification |
|---|---|---|
| 422 | sso_not_supported | Le panneau ne prend pas en charge la connexion en un clic. |
| 500 | sso_failed | L'URL n'a pas pu être générée. |
Utilisez l'URL immédiatement ; ne la stockez pas et ne l'écrivez pas dans des fichiers journaux.
POST/services/{id}/passwordChanger le mot de passe du service Activé
Pour les services d'hébergement et de serveur, change le mot de passe sur le panneau et met à jour nos enregistrements.
| Champ | Type | Description |
|---|---|---|
passwordobligatoire | chaîne | Nouveau mot de passe. Une règle de longueur minimale s'applique ; certains panneaux appliquent des règles supplémentaires. Sur les serveurs VDS, le mot de passe doit comporter de 8 à 14 caractères et ne peut contenir que ! @ _ - . comme caractères spéciaux. |
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 | Signification |
|---|---|---|
| 422 | password_not_supported | Ce type de service ne permet pas de changer le mot de passe. |
| 422 | password_too_short | Le mot de passe est trop court ; details.min indique la longueur minimale. |
| 422 | password_change_failed | Le panneau a refusé le mot de passe ; le message indique la règle du panneau. |
PATCH/services/{id}Paramètres du service Désactivé
Renouvellement automatique (auto_renew) et adresse de facturation (billing_profile_id).
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/services/{id}/metricsMétriques d'utilisation Désactivé
Utilisation et frais estimés des métriques facturées à l'usage.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/services/{id}/metrics/billingHistorique de facturation des métriques Désactivé
Utilisation et montants facturés par période.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PATCH/services/{id}/metrics/{key}Activer/désactiver une métrique Désactivé
{"enabled": true}
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/services/{id}/module-methodAppeler une méthode du panneau Désactivé
Exécute les méthodes personnalisées du panneau mises à la disposition des clients.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Compte
Informations du compte et du profil. 1 / 5 activé
GET/meInformations de votre compte Activé
Profil, coordonnées et informations de facturation (société), devise et solde actuel. meta.editable liste les champs modifiables et meta.required les champs obligatoires.
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"] }
}La réponse contient aussi les champs avatar_url, landline_phone, identity, birthday, date_format et group_id.
PATCH/meModifier les informations du compte Désactivé
Prénom, nom, société, téléphone, langue, pays, devise, fuseau horaire, champs personnalisés et photo de profil (base64). L'adresse e-mail ne peut pas être modifiée avec ce point de terminaison.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/me/securityÉtat de la sécurité Désactivé
Vérification de l'e-mail et du téléphone, authentification à deux facteurs et sessions actives.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/me/notificationsPréférences de notification Désactivé
Préférences de notification par e-mail et SMS, par catégorie.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/me/notificationsModifier les préférences de notification Désactivé
Sous la forme {"invoices": {"email": true, "sms": false}} ; les catégories non envoyées sont désactivées.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Domaines
Recherche, enregistrement et transfert de domaines, gestion des serveurs de noms, du DNS et du WHOIS. 0 / 43 activé
Ce groupe est actuellement désactivé pour votre compte. Les points de terminaison sont listés à titre d'information ; si vous souhaitez les utiliser, ouvrez un ticket d'assistance.
GET/domains/tldsExtensions et prix Désactivé
Prix d'enregistrement, de transfert et de renouvellement ; prix par année avec ?tld=com.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/checkVérifier un domaine Désactivé
{"domain": "ornekfirma.com"} → disponibilité, statut premium et prix d'enregistrement.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/registerEnregistrer un domaine Désactivé
Commande d'enregistrement avec la durée en années, les serveurs de noms, les contacts WHOIS et les add-ons ; réglée avec le solde.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/transferTransfert de domaine Désactivé
Commande de transfert entrant avec un code EPP (code de transfert).
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domainsListe des domaines Désactivé
Avec status=expiring, les domaines qui expirent dans les 30 jours.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}Détails du domaine Désactivé
Le paramètre de chemin peut être l'ID du service ou le nom de domaine lui-même. Verrouillage, protection de la vie privée, serveurs de noms, fonctionnalités disponibles, options de renouvellement.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PATCH/domains/{domain}Paramètres du domaine Désactivé
Renouvellement automatique et adresse de facturation.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/renewRenouveler un domaine Désactivé
{"years": 1} → facture de renouvellement.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/transfer-statusÉtat du transfert Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/nameserversServeurs de noms Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/nameserversModifier les serveurs de noms Désactivé
{"nameservers": ["ns1.hanhosting.com", "ns2.hanhosting.com"]} (2–4 entrées).
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/child-nameserversServeurs de noms enfants Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/child-nameserversAjouter un serveur de noms enfant Désactivé
{"host": "ns1.ornekfirma.com", "ip": "…"}
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/{domain}/child-nameserversSupprimer un serveur de noms enfant Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/transfer-lockÉtat du verrouillage du transfert Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/transfer-lockActiver/désactiver le verrouillage du transfert Désactivé
{"locked": true}
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/auth-codeEnvoyer le code de transfert par e-mail Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/auth-codeEnregistrer le code pour un transfert entrant Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/dns-recordsEnregistrements DNS Désactivé
Nécessite l'add-on de gestion DNS.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/dns-recordsAjouter un enregistrement DNS Désactivé
{"type": "A", "name": "www", "value": "…", "ttl": 3600}
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/dns-recordsModifier un enregistrement DNS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/{domain}/dns-recordsSupprimer un enregistrement DNS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/dnssecEnregistrements DNSSEC Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/dnssecAjouter un enregistrement DNSSEC Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/{domain}/dnssecSupprimer un enregistrement DNSSEC Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/whoisContacts WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/whoisModifier les contacts WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/whois/applyAppliquer un profil WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/whois-privacyConfidentialité WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/email-forwardsRedirections e-mail Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/email-forwardsAjouter une redirection e-mail Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/{domain}/email-forwardsSupprimer une redirection e-mail Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/{domain}/forwardingRedirection d'URL Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/{domain}/forwardingDéfinir la redirection d'URL Désactivé
{"url": "https://…", "method": 301}
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/{domain}/forwardingSupprimer la redirection d'URL Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/{domain}/addons/{key}Acheter un add-on de domaine Désactivé
dns-management, whois-privacy, forwarding ; facture calculée au prorata de la durée restante.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/whois-profilesProfils WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/whois-profilesCréer un profil WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/whois-profiles/{pid}Modifier un profil WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/domains/whois-profiles/{pid}Supprimer un profil WHOIS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/domains/whois-profiles/{pid}/defaultProfil WHOIS par défaut Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/domains/default-nameserversServeurs de noms par défaut Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/domains/default-nameserversModifier les serveurs de noms par défaut Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Adresses de facturation
Adresses de facturation enregistrées. 0 / 6 activé
Ce groupe est actuellement désactivé pour votre compte. Les points de terminaison sont listés à titre d'information ; si vous souhaitez les utiliser, ouvrez un ticket d'assistance.
GET/addressesAdresses de facturation Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/addressesAjouter une adresse Désactivé
Obligatoires : prénom, nom, e-mail, pays, province, district, adresse, code postal ; nom de la société pour une adresse d'entreprise.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/addresses/{id}Détails de l'adresse Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/addresses/{id}Modifier une adresse Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
DELETE/addresses/{id}Supprimer une adresse Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/addresses/{id}/defaultDéfinir comme adresse par défaut Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Tickets d'assistance
Ouverture, réponse et clôture des tickets d'assistance. 0 / 11 activé
Ce groupe est actuellement désactivé pour votre compte. Les points de terminaison sont listés à titre d'information ; si vous souhaitez les utiliser, ouvrez un ticket d'assistance.
GET/tickets/departmentsDépartements d'assistance Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/tickets/access-groupsGroupes d'informations d'accès Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/ticketsTickets d'assistance Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/ticketsOuvrir un ticket d'assistance Désactivé
Département, sujet, message ; facultatifs : service, priorité et pièces jointes en base64.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/tickets/{id}Détails du ticket et messages Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/tickets/{id}/replyRépondre à un ticket Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/tickets/{id}/closeClôturer un ticket Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/tickets/{id}/reopenRouvrir un ticket Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/tickets/{id}/ratingNoter un ticket Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/tickets/{id}/replies/{rid}/ratingNoter une réponse Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/tickets/{id}/attachments/{aid}Télécharger une pièce jointe (base64) Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
SMS
Envoi de SMS et historique des envois. 0 / 5 activé
Ce groupe est actuellement désactivé pour votre compte. Les points de terminaison sont listés à titre d'information ; si vous souhaitez les utiliser, ouvrez un ticket d'assistance.
GET/sms/sendersNoms d'expéditeur Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/sms/quoteCalculer le prix du SMS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/sms/sendEnvoyer un SMS Désactivé
Le montant est débité de votre solde ; il est remboursé si l'envoi échoue.
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/sms/messagesSMS envoyés Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/sms/messages/{id}Détails du SMS Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Programme d'affiliation
Programme d'affiliation et commissions. 0 / 5 activé
Ce groupe est actuellement désactivé pour votre compte. Les points de terminaison sont listés à titre d'information ; si vous souhaitez les utiliser, ouvrez un ticket d'assistance.
GET/affiliateRécapitulatif d'affiliation Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
GET/affiliate/commissionsCommissions Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/affiliate/enrollRejoindre le programme Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
POST/affiliate/withdrawDemander un versement Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
PUT/affiliate/payment-methodEnregistrer le mode de versement Désactivé
Ce point de terminaison n'est pas activé pour votre compte : il n'apparaît pas dans les autorisations de la clé et renvoie 403 en cas d'appel. Si vous souhaitez l'utiliser, ouvrez un ticket d'assistance.
Sécurité et bonnes pratiques
- Créez une clé distincte pour chaque intégration et n'accordez que les autorisations nécessaires ; par exemple, n'attribuez pas
Orders/CreateOrderà un outil de reporting qui ne fait que lire des données. - Verrouillez la clé sur l'adresse IP de votre serveur.
- Utilisez
Idempotency-Keysur chaque requête POST qui entraîne un mouvement d'argent. - Vérifiez le total avec
POST /orders/previewavant de commander ; si un montant inattendu est renvoyé, n'envoyez pas la commande. - Les informations d'accès au service (
access.password) sont renvoyées en clair ; stockez-les uniquement dans un environnement chiffré et ne les écrivez pas dans des fichiers journaux. - Si vous soupçonnez une fuite de la clé, utilisez immédiatement Révoquer ou Régénérer sur la page des clés.
Contactez le service commercial et l'assistance
Une question avant d'acheter, ou besoin d'aide pour un compte existant ? Appelez-nous ou écrivez-nous par e-mail.