Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

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.

REST + JSON Authentification par clé Commandes automatiques avec le solde

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.

Produits et prixOffres actuelles, cycles de facturation, add-ons et options de commande.
Commandes automatiquesCalculez d'abord le total, puis créez la commande et payez-la avec votre solde.
Factures et soldeListez les factures ouvertes et payez-les avec votre solde ; suivez les transactions de votre solde.
Gestion des servicesRenouvellements, demandes de résiliation, connexion au panneau de gestion, mots de passe et outils du service.

URL de base

URL de base
https://hanhosting.com/api/v1/client

Tous 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.

  1. Ouvrez la page des clés. Espace client → Identifiants API → Créer une clé API.
  2. 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 noms Group/Action utilisés dans ce document (par exemple Orders/CreateOrder).
  3. 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.
  4. 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.

AutorisationPoint de terminaisonCe qu'elle permet
Account/GetMeGET /meInformations de votre compte
Products/GetProductsGET /productsListe des produits
Products/GetProductCategoriesGET /products/categoriesCatégories de produits
Products/GetProductGET /products/{id}Détails du produit et options de commande
Orders/PreviewOrderPOST /orders/previewCalculer le total de la commande (aperçu)
Orders/CreateOrderPOST /ordersCréer et payer une commande
Orders/GetOrdersGET /ordersListe des commandes
Orders/GetOrderGET /orders/{id}Détails de la commande
Invoices/GetInvoicesGET /invoicesListe des factures
Invoices/GetInvoiceGET /invoices/{id}Détails de la facture
Invoices/PayInvoicePOST /invoices/{id}/payPayer une facture avec le solde
Balance/GetBalanceGET /balanceSolde du compte
Balance/GetBalanceTransactionsGET /balance/transactionsTransactions du solde
Services/GetServicesGET /servicesListe des services
Services/GetServiceGET /services/{id}Détails du service et informations d'accès
Services/RenewServicePOST /services/{id}/renewCréer une facture de renouvellement
Services/GetServiceInvoicesGET /services/{id}/invoicesFactures du service
Services/GetServiceAddonsGET /services/{id}/addonsAdd-ons du service
Services/CreateCancellationPOST /services/{id}/cancellationCréer une demande de résiliation
Services/RevokeCancellationDELETE /services/{id}/cancellationRetirer une demande de résiliation
Services/GetServiceDashboardGET /services/{id}/dashboardRésumé du panneau du service
Services/GetServiceToolsGET /services/{id}/toolsOutils du service
Services/GetServiceToolDataGET /services/{id}/tools/{tool}Lire les données d'un outil
Services/RunServiceToolActionPOST /services/{id}/tools/{tool}/{action}Exécuter une action d'outil
Services/GetServiceSsoPOST /services/{id}/ssoURL de connexion en un clic au panneau
Services/ChangeServicePasswordPOST /services/{id}/passwordChanger 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 :

En-tête HTTP
Authorization: Bearer wck_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Certaines 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"

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 (ou PUT, 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.

Réponse en cas de succès
{
  "data": [ { "id": 1204, "name": "HAN-MC-1", "status": "active" } ],
  "meta": { "total": 37, "page": 1, "limit": 25, "next_page": 2 }
}

Réponse d'erreur

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, null est renvoyé.
  • Clés des cycles de facturation (cycle) : monthly, quarterly, semiannually, annually, biennially, triennially, onetime (ainsi que hourly, daily, weekly pour les produits facturés à l'heure, à la journée ou à la semaine). pricing dans GET /products/{id} indique les cycles avec lesquels un produit est vendu.

Statuts HTTP et codes d'erreur généraux

HTTPCodeSignification et marche à suivre
401missing_tokenAucune clé n'a été envoyée. Ajoutez Authorization: Bearer ... ou X-Api-Key.
401invalid_tokenLa clé n'a pas été reconnue ou est mal formée. Vérifiez que vous avez copié la clé complète.
401key_revokedLa clé a été révoquée. Créez une nouvelle clé.
401owner_inactiveVotre compte n'est pas actif ; contactez l'assistance.
403ip_not_allowedLa 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.
403account_not_allowedVotre compte ne figure pas sur la liste des comptes ayant accès à l'API. Contactez l'assistance pour obtenir l'accès à l'API.
403insufficient_scopeLa 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.
403client_api_not_allowed, client_scope_revoked, surface_disabledL'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.
403audience_mismatchLa clé n'a pas été créée pour cette API. Utilisez une clé créée sur la page Identifiants API de votre Espace client.
400operation_failedL'opération n'a pas pu aboutir ; lisez le message et, si nécessaire, transmettez-le à l'assistance.
404endpoint_not_found, not_foundL'URL n'existe pas, ou l'enregistrement demandé (service, facture, commande...) ne vous appartient pas.
405method_not_allowedL'URL est correcte mais la méthode HTTP est erronée (par exemple GET au lieu de POST).
409idempotency_in_flightLa 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é.
413payload_too_largeLe corps est trop volumineux (en général, de gros fichiers base64).
422idempotency_key_invalid, idempotency_key_reuseIdempotency-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.
422validation_failed et codes propres au point de terminaisonLa 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.
429rate_limitedLa limite de requêtes par minute a été dépassée. Attendez le délai indiqué dans Retry-After.
429abuse_lockout, too_many_auth_failuresVerrouillage temporaire (15 minutes) en raison d'une charge excessive ou d'un trop grand nombre d'échecs d'authentification.
500server_error et codes propres au point de terminaisonErreur 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 /ping ni 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-After vous 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) et limit (1–100, 25 par défaut).
  • Le champ meta de la réponse : total (nombre total d'enregistrements), page, limit, next_page (0 sur la dernière page).
  • search recherche 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 sort et dir.
PHP · parcourir toutes les pages
$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_flight est 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é.

En-tête HTTP
Idempotency-Key: bayi-siparis-2026-000184

Scé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 :

  1. Consultez le produit et ses options : GET /products/{id}. pricing indique les cycles proposés, requirements et addons les choix que vous devez envoyer avec la commande, et domain.mode si un domaine est nécessaire.
  2. Vérifiez votre solde : GET /balance.
  3. Calculez le total : POST /orders/preview renvoie le total, coupons et taxes compris, sans créer de commande.
  4. 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.
  5. Suivez la mise en service : récupérez l'ID du service dans services[] de GET /orders/{id} ; dès que GET /services/{id} indique le statut active, transmettez les informations d'accès (access) à votre client.
PHP · exemple complet
$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

  1. GET /services/{id} → consultez les cycles renouvelables avec renewal.available et renewal.cycles. Si le service a une facture ouverte, renewal.open_invoice_id est renseigné.
  2. 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 avec existing: true.
  3. 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}/sso renvoie 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}/dashboard renvoie le nom du panneau, les actions disponibles et les jauges de ressources.
  • Outils du service : GET /services/{id}/tools liste les outils disponibles pour votre service et les actions de chaque outil (capabilities). Utilisez GET /services/{id}/tools/{tool} pour lire des données et POST /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 · créer un compte e-mail sur l'hébergement
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.

  1. Consultez l'état de la machine : GET /services/{id}/tools/vnc-console. Le champ power renvoie running, stopped, installing ou suspended. Si la machine est éteinte, démarrez-la d'abord avec POST /services/{id}/tools/start-server/execute ; si une installation est en cours, attendez qu'elle se termine.
  2. Obtenez une URL de connexion : POST /services/{id}/tools/vnc-console/create (aucun corps de requête nécessaire). Le champ data.url de la réponse est une URL à usage unique de la forme wss://console.hanhosting.com/…/beconsole/….
  3. 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 · obtenir une URL de 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"
Exemple de réponse · HTTP 200
{ "data": { "status": "successful", "url": "wss://console.hanhosting.com/4/beconsole/…" } }
JavaScript · affichage dans le navigateur avec noVNC
// The API key never reaches the browser: your own server gets the URL from the API and gives the browser only the wss URL.
import RFB from './novnc/core/rfb.js';   // core/rfb.js from the noVNC source

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

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

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

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_failed est 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_failed est 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.

Aucun point de terminaison ne correspond à votre recherche.

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.

Autorisation : non requiseGET https://hanhosting.com/api/v1/client/ping
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/ping" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "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.

Autorisation : non requiseGET https://hanhosting.com/api/v1/client/whoami
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/whoami" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "id": 12,
    "type": "client",
    "name": "bayi-otomasyon",
    "permissions": ["Products/GetProducts", "Orders/PreviewOrder", "Orders/CreateOrder", "Balance/GetBalance"],
    "last_access": "2026-10-01 14:18:02",
    "owner_id": 1001
  }
}
GET/reference/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.

Autorisation : non requiseGET https://hanhosting.com/api/v1/client/reference/countries
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/reference/countries" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "data": [ { "code": "TR", "name": "Turkey" }, { "code": "DE", "name": "Germany" } ] }
GET/reference/countries/{code}/statesProvinces d'un pays Aucune autorisation requise
Autorisation : non requiseGET https://hanhosting.com/api/v1/client/reference/countries/{code}/states
Paramètres de chemin
ChampTypeDescription
codeobligatoirechaîneCode du pays (ISO-2), p. ex. TR
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/reference/countries/TR/states" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "data": [ { "id": 34, "name": "Istanbul" }, { "id": 6, "name": "Ankara" } ] }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundCode de pays introuvable.
GET/reference/states/{id}/citiesDistricts d'une province Aucune autorisation requise
Autorisation : non requiseGET https://hanhosting.com/api/v1/client/reference/states/{id}/cities
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID de la province (issu de la réponse GetStates)
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/reference/states/34/cities" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "data": [ { "id": 1103, "name": "Kadikoy" }, { "id": 1104, "name": "Uskudar" } ] }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundProvince 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.

Autorisation : Products/GetProductsGET https://hanhosting.com/api/v1/client/products
Paramètres de requête
ChampTypeDescription
typechaîneType de produit : hosting, server, software, special ... Un type invalide renvoie 422 type_invalid ainsi que les types autorisés.
categoryentierID de la catégorie (GetProductCategories).
searchchaîneRecherche dans les noms de produit.
page, limitentierPagination (limit 1–100, 25 par défaut).
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/products?category=35" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    {
      "id": 176,
      "type": "server",
      "title": "HAN-MC-1",
      "tagline": "",
      "category": { "id": 35, "name": "Minecraft Server" },
      "in_stock": true,
      "stock": null,
      "pricing": [
        { "cycle": "monthly",   "price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "promo": false },
        { "cycle": "quarterly", "price": { "amount": 540.00, "currency": "TRY" }, "setup": null, "promo": false },
        { "cycle": "annually",  "price": { "amount": 2160.00, "currency": "TRY" }, "setup": null, "promo": false }
      ]
    }
  ],
  "meta": { "total": 9, "page": 1, "limit": 25, "next_page": 0, "currency": "TRY" }
}
GET/products/categoriesCatégories de produits Activé
Autorisation : Products/GetProductCategoriesGET https://hanhosting.com/api/v1/client/products/categories
Paramètres de requête
ChampTypeDescription
typechaîneUniquement les catégories de ce type.
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/products/categories" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "id": 34, "parent": null, "type": "server", "name": "Game Servers" },
    { "id": 35, "parent": 34, "type": "server", "name": "Minecraft Server" }
  ],
  "meta": { "total": 2 }
}
GET/products/{id}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).

Autorisation : Products/GetProductGET https://hanhosting.com/api/v1/client/products/{id}
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID du produit
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/products/176" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "id": 176,
    "type": "server",
    "title": "HAN-MC-1",
    "tagline": "",
    "description": "…",
    "category": { "id": 35, "name": "Minecraft Server" },
    "in_stock": true,
    "stock": null,
    "quantity": { "allowed": false, "mode": 0 },
    "order_limit_per_user": null,
    "pricing": [ { "cycle": "monthly", "price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "promo": false } ],
    "addons": [
      {
        "id": 11, "name": "EXTRA RAM", "description": "", "field_type": "select", "required": false,
        "options": [ { "id": 0, "name": "2 GB", "cycle": "monthly", "price": { "amount": 60.00, "currency": "TRY" } } ],
        "requirements": []
      }
    ],
    "requirements": [
      { "id": 3, "name": "Installation Type", "field_type": "radio", "required": false,
        "options": [ { "id": "0", "name": "Game Panel (Web Panel)" }, { "id": "1", "name": "VDS Server" } ] },
      { "id": 5, "name": "Operating System", "field_type": "radio", "required": false,
        "options": [ { "id": "0", "name": "26.04 LTS" }, { "id": "1", "name": "24.04 LTS" } ] }
    ],
    "metrics": [],
    "domain": { "mode": "none" }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLe 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.

Autorisation : Orders/PreviewOrderPOST https://hanhosting.com/api/v1/client/orders/preview
Champs du corps de la requête (JSON)
ChampTypeDescription
itemsobligatoiretableauÉléments de commande ; même structure que pour POST /orders.
couponstableauCodes de coupon.
billing_profile_identierAdresse de facturation enregistrée (détermine le taux de taxe).
paymentobjet{"method": "balance"} ; sert uniquement à inclure les frais du moyen de paiement (fee) dans le calcul.
Exemple de requête
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" } }
  ]
}'
Exemple de réponse
HTTP 200
{
  "data": {
    "items": [
      { "kind": "product", "product_id": 176, "name": "HAN-MC-1", "cycle": "monthly", "quantity": 1,
        "domain": null, "unit_price": { "amount": 180.00, "currency": "TRY" }, "setup": null, "total": { "amount": 180.00, "currency": "TRY" } }
    ],
    "subtotal": { "amount": 180.00, "currency": "TRY" },
    "discount": { "amount": 0.00, "currency": "TRY" },
    "tax": { "amount": 36.00, "currency": "TRY" },
    "fee": null,
    "total": { "amount": 216.00, "currency": "TRY" }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
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.

Autorisation : Orders/CreateOrderPOST https://hanhosting.com/api/v1/client/orders Idempotency-Key recommandé
Champs du corps de la requête (JSON)
ChampTypeDescription
termsobligatoirebooléenAcceptation du contrat de services : doit être le booléen JSON true ; sinon, 422 terms_required.
itemsobligatoiretableauJusqu'à 20 éléments. Les champs d'un élément sont détaillés ci-dessous.
items[].product_idobligatoireentierID du produit (doit être en vente).
items[].cycleobligatoirechaîneClé du cycle de facturation ; l'une de celles de la liste pricing du produit.
items[].quantityentier1 par défaut. Si le produit ne permet pas de choisir une quantité, la valeur 1 est retenue.
items[].requirementsobjetChoix 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_filesobjetChoix de commande qui demandent un fichier : {"<id>": "base64 or data-URI"}.
items[].addonsobjetAdd-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_qtyobjetQuantité pour les add-ons vendus à l'unité : {"11": 2}.
items[].metricstableauID des métriques, pour activer les métriques facturées à l'usage.
items[].domainobjetPour 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": "…"}.
paymentobligatoireobjet{"method": "balance"}. Non requis si le total est 0.
couponstableauCodes de coupon.
billing_profile_identierAdresse de facturation enregistrée ; si elle est omise, l'adresse du compte est utilisée.
noteschaîneNote de commande (1000 caractères maximum).
Exemple de requête
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"
}'
Exemple de réponse
HTTP 201
{
  "data": {
    "order_id": 3120,
    "number": "3120",
    "status": "waiting",
    "total": { "amount": 288.00, "currency": "TRY" },
    "payment": { "method": "balance", "status": "paid" },
    "invoice": {
      "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid",
      "total": { "amount": 288.00, "currency": "TRY" }, "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01"
    }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422terms_requiredterms n'a pas été envoyé avec la valeur true.
422items_required, items_invalid, too_many_itemsAucun élément, liste mal formée ou plus de 20 éléments.
422item_invalid, product_requiredUn élément n'est pas un objet, ou product_id est absent.
422product_not_orderableLe produit n'est pas en vente.
422cycle_invalidCe produit ne propose pas ce cycle ; details.allowed liste les cycles valides.
422item_unpricedAucun prix n'est défini pour ce cycle.
422out_of_stock, order_limit_reachedRupture de stock, ou la limite de commande du produit est atteinte.
422addon_invalid, addon_option_invalidL'add-on n'appartient pas à ce produit, ou l'option n'existe pas.
422requirement_missingUn choix obligatoire n'a pas été envoyé.
422file_url_not_allowed, file_upload_failedUne URL a été fournie pour un champ de fichier, ou le fichier base64 n'a pas pu être enregistré.
422metric_invalidLa métrique n'appartient pas à ce produit.
422domain_required, domain_invalid, subdomain_invalid, subdomain_base_invalidLe choix de domaine est absent ou invalide.
422license_domain_required, license_ip_requiredAucun domaine ni aucune IP n'a été envoyé pour un produit de licence.
422domain_acquisition_not_hereLes nouveaux enregistrements et transferts de domaine ne peuvent pas être effectués avec ce point de terminaison.
422coupon_invalidLe coupon est invalide ou ne peut pas être appliqué à cette commande.
422payment_method_invalid, payment_method_unavailableLe moyen de paiement est absent, invalide ou indisponible. Envoyez balance.
422insufficient_balanceSolde insuffisant ; la commande n'est pas créée. details.required et details.available (nombres) sont renvoyés.
422account_restricted, checkout_blockedVotre compte n'est pas autorisé à passer des commandes.
404not_foundL'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.

Autorisation : Orders/GetOrdersGET https://hanhosting.com/api/v1/client/orders
Paramètres de requête
ChampTypeDescription
page, limitentierPagination.
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/orders" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "id": 3120, "number": "3120", "status": "active", "total": { "amount": 288.00, "currency": "TRY" }, "payment_method": "Balance",
      "invoice_id": 5871, "items_count": 1, "created_at": "2026-10-01" }
  ],
  "meta": { "total": 14, "page": 1, "limit": 25, "next_page": 0 }
}
GET/orders/{id}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.

Autorisation : Orders/GetOrderGET https://hanhosting.com/api/v1/client/orders/{id}
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID de la commande
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/orders/3120" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "id": 3120, "number": "3120", "status": "active", "total": { "amount": 288.00, "currency": "TRY" }, "payment_method": "Balance",
    "invoice_id": 5871, "items_count": 1, "created_at": "2026-10-01",
    "items": [ { "name": "HAN-MC-1", "quantity": 1, "total": { "amount": 288.00, "currency": "TRY" } } ],
    "services": [ { "id": 1204, "name": "HAN-MC-1", "type": "server", "status": "active" } ],
    "invoice": { "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid", "total": { "amount": 288.00, "currency": "TRY" },
                 "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01" },
    "notes": "Reseller customer #184"
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLa 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.

Autorisation : Invoices/GetInvoicesGET https://hanhosting.com/api/v1/client/invoices
Paramètres de requête
ChampTypeDescription
statuschaînepaid, unpaid, overdue, refunded, cancelled, waiting.
searchchaîneNuméro de facture ou description de la première ligne de facture.
sortchaînecreated, due, price
dirchaîneasc / desc (desc par défaut)
page, limitentierPagination.
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/invoices?status=overdue" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "invoice_id": 5902, "number": "HAN2026-5902", "status": "unpaid", "state": "overdue", "total": { "amount": 180.00, "currency": "TRY" },
      "created_at": "2026-09-20", "paid_at": null, "due_date": "2026-09-28", "first_item": "HAN-MC-1 (Monthly renewal)" }
  ],
  "meta": { "total": 1, "page": 1, "limit": 25, "next_page": 0 }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422status_invalidValeur 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.

Autorisation : Invoices/GetInvoiceGET https://hanhosting.com/api/v1/client/invoices/{id}
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID de la facture
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/invoices/5902" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "invoice_id": 5902, "number": "HAN2026-5902", "status": "unpaid", "state": "overdue",
    "total": { "amount": 180.00, "currency": "TRY" }, "amount_due": { "amount": 180.00, "currency": "TRY" }, "payable": true,
    "created_at": "2026-09-20", "paid_at": null, "due_date": "2026-09-28",
    "items": [
      { "item_id": 9911, "description": "HAN-MC-1 (Monthly renewal)", "service_id": 1204, "cycle": "monthly",
        "period_start": "2026-10-01", "period_end": "2026-10-31", "quantity": 1,
        "unit_price": { "amount": 150.00, "currency": "TRY" }, "total": { "amount": 150.00, "currency": "TRY" } }
    ],
    "summary": {
      "subtotal": { "amount": 150.00, "currency": "TRY" }, "tax": { "rate": 20, "amount": { "amount": 30.00, "currency": "TRY" } },
      "total": { "amount": 180.00, "currency": "TRY" }, "paid": { "amount": 0.00, "currency": "TRY" }, "amount_due": { "amount": 180.00, "currency": "TRY" }
    },
    "transactions": []
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLa 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.

Autorisation : Invoices/PayInvoicePOST https://hanhosting.com/api/v1/client/invoices/{id}/pay Idempotency-Key recommandé
Champs du corps de la requête (JSON)
ChampTypeDescription
idobligatoireentierID de la facture (dans le chemin)
payment.methodobligatoirechaînebalance
Exemple de requête
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" } }'
Exemple de réponse
HTTP 200
{
  "data": {
    "invoice": { "invoice_id": 5902, "number": "HAN2026-5902", "status": "paid", "state": "paid",
                 "total": { "amount": 180.00, "currency": "TRY" }, "amount_due": { "amount": 0.00, "currency": "TRY" }, "paid_at": "2026-10-01" },
    "payment": { "method": "balance", "status": "paid" }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422invoice_not_payableLa facture n'est pas impayée, ou elle n'a aucun montant dû.
422subscription_collectsCette facture est réglée par un abonnement.
422balance_not_allowedUne facture d'alimentation du solde ne peut pas être payée avec le solde.
422payment_method_invalid, payment_method_unavailableLe moyen de paiement est absent, invalide ou indisponible. Envoyez balance.
422payment_rejectedLe paiement a été refusé.
422insufficient_balanceVotre solde ne couvre pas le montant dû (frais éventuels compris).
429invoice_payment_in_progressLa même facture est en cours de paiement par une autre requête.
500wallet_charge_failedLe 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"}.

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

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.

Autorisation : Balance/GetBalanceGET https://hanhosting.com/api/v1/client/balance
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/balance" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "balance": { "amount": 2500.00, "currency": "TRY" },
    "wallet_empty": false,
    "low_balance": false,
    "auto_pay": { "from_balance": true, "available": true, "backup_card": null },
    "alert": { "enabled": true, "threshold": { "amount": 500.00, "currency": "TRY" },
               "recipients": [ { "id": 0, "name": "Name Surname", "email": "[email protected]", "enabled": true, "owner": true } ] }
  }
}
GET/balance/transactionsTransactions du solde Activé
Autorisation : Balance/GetBalanceTransactionsGET https://hanhosting.com/api/v1/client/balance/transactions
Paramètres de requête
ChampTypeDescription
typechaîneup (alimentation) / down (dépense)
searchchaîneRecherche dans les descriptions.
page, limitentierPagination.
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/balance/transactions" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "transaction_id": 88213, "type": "down", "amount": { "amount": 288.00, "currency": "TRY" }, "description": "Invoice #HAN2026-5871",
      "invoice_id": 5871, "created_at": "2026-10-01T14:20:05+03:00" }
  ],
  "meta": { "total": 42, "page": 1, "limit": 25, "next_page": 2 }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422type_invalidType 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.

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

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.

Autorisation : Services/GetServicesGET https://hanhosting.com/api/v1/client/services
Paramètres de requête
ChampTypeDescription
statuschaîneactive, pending, suspended, expired, cancelled
typechaînehosting, server, software, special
searchchaîneRecherche dans le nom, le domaine ou le nom du serveur.
page, limitentierPagination.
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services?status=active" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "id": 1204, "type": "server", "name": "HAN-MC-1", "status": "active", "host": "203.0.113.25:25565",
      "product_id": 176, "auto_renew": true, "price": { "amount": 180.00, "currency": "TRY" }, "cycle": "monthly",
      "created_at": "2026-10-01", "due_date": "2026-11-01" }
  ],
  "meta": { "total": 1, "page": 1, "limit": 25, "next_page": 0 }
}
GET/services/{id}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).

Autorisation : Services/GetServiceGET https://hanhosting.com/api/v1/client/services/{id}
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID du service
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "id": 1204, "type": "server", "name": "HAN-MC-1", "status": "active",
    "product": { "id": 176, "name": "HAN-MC-1" }, "host": "203.0.113.25:25565", "order_id": 3120,
    "auto_renew": true, "auto_renew_locked": false, "managed": false, "billing_profile_id": 0,
    "price": { "amount": 180.00, "currency": "TRY" }, "cycle": "monthly",
    "created_at": "2026-10-01", "due_date": "2026-11-01",
    "access": { "ip": "203.0.113.25", "username": "…", "password": "…" },
    "renewal": {
      "available": true, "blocked_by_subscription": false, "already_invoiced": false, "open_invoice_id": 0,
      "cycles": [ { "cycle": "monthly", "price": { "amount": 180.00, "currency": "TRY" }, "save_pct": 0 },
                  { "cycle": "annually", "price": { "amount": 2160.00, "currency": "TRY" }, "save_pct": 0 } ]
    },
    "cancellation": null,
    "has_metrics": false
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLe 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.

Autorisation : Services/RenewServicePOST https://hanhosting.com/api/v1/client/services/{id}/renew Idempotency-Key recommandé
Champs du corps de la requête (JSON)
ChampTypeDescription
idobligatoireentierID du service (dans le chemin)
cyclechaîneCycle de renouvellement ; l'un de ceux de renewal.cycles. S'il est omis, le cycle actuel est utilisé.
Exemple de requête
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" }'
Exemple de réponse
HTTP 201
{
  "data": {
    "invoice_id": 5933, "number": "HAN2026-5933", "status": "unpaid", "state": "unpaid",
    "total": { "amount": 2160.00, "currency": "TRY" }, "created_at": "2026-10-01", "paid_at": null, "due_date": "2026-11-01",
    "existing": false
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422cycle_invalidCe cycle n'est pas proposé pour le renouvellement.
422not_renewableLe service n'est pas au statut actif, expiré ou annulé.
422already_invoicedCette période a déjà été facturée.
422renew_blocked_subscriptionLe service est renouvelé par un abonnement.
422renew_disabled, renew_rejectedAucune facture de renouvellement ne peut être émise pour ce service.
422account_restrictedVotre compte n'est pas autorisé à effectuer des renouvellements.
500renew_failedLa 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é
Autorisation : Services/GetServiceInvoicesGET https://hanhosting.com/api/v1/client/services/{id}/invoices
Paramètres de requête
ChampTypeDescription
limitentier1–100, 25 par défaut
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/invoices" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "invoice_id": 5871, "number": "HAN2026-5871", "status": "paid", "state": "paid", "total": { "amount": 288.00, "currency": "TRY" },
      "created_at": "2026-10-01", "paid_at": "2026-10-01", "due_date": "2026-10-01" }
  ]
}
GET/services/{id}/addonsAdd-ons du service Activé

Add-ons en attente, actifs et suspendus (RAM supplémentaire, adresse IP supplémentaire, etc.).

Autorisation : Services/GetServiceAddonsGET https://hanhosting.com/api/v1/client/services/{id}/addons
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/addons" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "id": 77, "addon_id": 11, "option_id": 0, "name": "EXTRA RAM", "option": "2 GB", "quantity": 1, "status": "active",
      "price": { "amount": 60.00, "currency": "TRY" }, "cycle": "monthly", "due_date": "2026-11-01", "unpaid_invoice_id": 0,
      "cancellation_requested": false }
  ]
}
GET/services/{id}/upgrade-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.

Autorisation : Services/GetService (aucune autorisation distincte)GET https://hanhosting.com/api/v1/client/services/{id}/upgrade-options
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID du service
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade-options" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "service": { "id": 1027, "product_id": 107, "name": "HAN-R9-6", "period": "month", "period_time": 1, "amount": 608.9, "currency": "TRY", "due_date": "2026-11-22 22:46:04" },
    "options": [
      { "product_id": 110, "name": "HAN-R9-8", "category": "Ryzen Premium VDS",
        "features": ["8 vCPU", "16 GB RAM", "200 GB NVMe"],
        "prices": [
          { "price_id": 581, "period": "month", "period_time": 1, "cycle": "Monthly", "amount": 808.9, "difference": 376.78,
            "reseller_discount": { "rate": 30, "amount": 113.03 }, "tax_rate": 0, "payable_total": 263.75, "currency": "TRY" }
        ] }
    ],
    "pending": null,
    "balance": { "available": 1520.4, "currency": "TRY" }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLe service n'existe pas ou ne vous appartient pas.
422service_not_activeSeuls les services actifs peuvent faire l'objet d'un upgrade.
403upgrades_disabledLes upgrades sont désactivés pour ce type de service.
403insufficient_scopeLa 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.

Autorisation : Services/GetService + Invoices/PayInvoice (aucune autorisation distincte)POST https://hanhosting.com/api/v1/client/services/{id}/upgrade Idempotency-Key recommandé
Champs du corps de la requête (JSON)
ChampTypeDescription
idobligatoireentierID du service (dans le chemin)
product_idobligatoireentierOffre cible, issue de la liste upgrade-options
price_identierCycle de facturation ; s'il est omis, le cycle actuel du service (p. ex. mensuel)
pay_with_balancebooléenPar 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_runbooléentrue : vérification et calcul du prix uniquement ; aucun enregistrement ni aucune facture n'est créé
Exemple de requête
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 }'
Exemple de réponse
HTTP 201
{
  "data": {
    "dry_run": false, "service_id": 1027,
    "from_product": { "id": 107, "name": "HAN-R9-6" }, "to_product": { "id": 110, "name": "HAN-R9-8" },
    "price": { "price_id": 581, "period": "month", "period_time": 1, "cycle": "Monthly", "amount": 808.9, "difference": 376.78,
               "reseller_discount": { "rate": 30, "amount": 113.03 }, "tax_rate": 0, "payable_total": 263.75, "currency": "TRY" },
    "pay_with_balance": true, "balance": { "available": 1520.4, "currency": "TRY" },
    "upgrade": { "id": 12, "type": "up", "status": "inprocess", "message": "", "from_product": { "id": 107, "name": "HAN-R9-6" },
                 "to_product": { "id": 110, "name": "HAN-R9-8" }, "invoice_id": 6120, "invoice_status": "paid", "created_at": "2026-11-01 03:10:00" },
    "invoice_id": 6120,
    "payment": { "method": "balance", "status": "paid" }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422product_not_upgradeableL'offre n'est pas une option d'upgrade pour ce service (autre famille ou offre inférieure).
422price_not_foundprice_id ne fait pas partie des cycles de facturation de cette offre.
422insufficient_balanceVotre solde ne suffit pas ; voir details.required / details.available.
422payment_failedLa facture n'a pas pu être payée avec le solde ; l'upgrade a été annulé.
409upgrade_pendingLe service a déjà un upgrade en cours ; suivez-le avec GET /services/{id}/upgrade.
403insufficient_scopeLa 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.

Autorisation : Services/GetService (aucune autorisation distincte)GET https://hanhosting.com/api/v1/client/services/{id}/upgrade
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID du service
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/upgrade" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "service": { "id": 1027, "product_id": 110, "name": "HAN-R9-8", "period": "month", "period_time": 1, "amount": 808.9, "currency": "TRY", "due_date": "2026-12-01 03:10:00" },
    "upgrade": { "id": 12, "type": "up", "status": "completed", "message": "", "from_product": { "id": 107, "name": "HAN-R9-6" },
                 "to_product": { "id": 110, "name": "HAN-R9-8" }, "invoice_id": 6120, "invoice_status": "paid", "created_at": "2026-11-01 03:10:00" }
  }
}
GET/services/{id}/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).

Autorisation : Services/GetService (aucune autorisation distincte)GET https://hanhosting.com/api/v1/client/services/{id}/rdns
Paramètres de chemin
ChampTypeDescription
idobligatoireentierID du service
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/rdns" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "service_id": 1058,
    "ips": [
      { "ip": "176.96.128.115", "ptr": "mail.ornekfirma.com", "default": "176-96-128-115.hanhosting.net", "custom": true },
      { "ip": "176.96.128.114", "ptr": "176-96-128-114.hanhosting.net", "default": "176-96-128-114.hanhosting.net", "custom": false }
    ],
    "monthly_limit": 2,
    "remaining_this_month": 1
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundLe service n'existe pas ou ne vous appartient pas.
503rdns_unavailableLe 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.

Autorisation : Services/GetService + Services/RunServiceToolAction (aucune autorisation distincte)POST https://hanhosting.com/api/v1/client/services/{id}/rdns
Champs du corps de la requête (JSON)
ChampTypeDescription
idobligatoireentierID du service (dans le chemin)
ipobligatoirechaîneUne IP du service (issue de GET /services/{id}/rdns)
hostnamechaîneNom PTR, p. ex. mail.ornekfirma.com. Vide ou omis : le nom par défaut est rétabli.
dry_runbooléentrue : vérification uniquement, sans modifier l'enregistrement
Exemple de requête
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" }'
Exemple de réponse
HTTP 200
{ "data": { "ip": "176.96.128.115", "ptr": "mail.ornekfirma.com", "dry_run": false, "unchanged": false, "remaining_this_month": 1 } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422a_record_missingL'enregistrement A du nom ne pointe pas vers cette IP ; details.a_records liste les enregistrements trouvés.
422invalid_hostnameNom invalide (lettres, chiffres, trait d'union, point ; au moins deux labels).
404ip_not_ownedL'IP n'appartient pas au service.
422ip_not_supportedLe DNS inverse de cette IP ne peut pas être modifié ici.
429monthly_limitLa limite de modifications de cette IP est atteinte pour ce mois-ci (2 par IP et par mois).
403insufficient_scopeLa 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.

Autorisation : Services/CreateCancellationPOST https://hanhosting.com/api/v1/client/services/{id}/cancellation
Champs du corps de la requête (JSON)
ChampTypeDescription
urgencyobligatoirechaînenow (immédiatement) / period-ending (à la fin de la période)
reasonobligatoirechaînenot-needed, too-expensive, switching, missing-features, other
reason_detailchaîne300 caractères maximum ; obligatoire si reason=other.
notechaîne500 caractères maximum.
Exemple de requête
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." }'
Exemple de réponse
HTTP 201
{
  "data": { "status": "pending", "urgency": "period-ending", "reason": "I no longer need it", "reason_key": "not-needed",
            "note": "The customer closed the project.", "requested_at": "2026-10-01" }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422not_actionableLe service n'est pas actif.
422cancellation_existsUne demande de résiliation ouverte existe déjà.
422urgency_invalid, reason_invalid, reason_detail_requiredDes valeurs de champ sont invalides ou absentes.
422cancellation_rejectedLa demande de résiliation n'a pas été acceptée pour ce service.
500cancellation_failedLa 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.

Autorisation : Services/RevokeCancellationDELETE https://hanhosting.com/api/v1/client/services/{id}/cancellation
Exemple de requête
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"
Exemple de réponse
HTTP 200
{ "data": { "revoked": true, "service_id": 1204 } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundIl 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.

Autorisation : Services/GetServiceDashboardGET https://hanhosting.com/api/v1/client/services/{id}/dashboard
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/dashboard" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": {
    "module": "Pterodactyl", "panel_name": "HanHosting Game Panel", "sso_available": true,
    "can_change_password": false, "has_tools": true, "methods": [],
    "quick_actions": [],
    "overview": { "gauges": [ { "key": "ram", "label": "RAM", "used": 1.2, "total": 2, "unit": "GB" } ], "resources": [], "account": [] }
  }
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422not_actionableLe service n'est pas actif.
422module_unavailableLe 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.

Autorisation : Services/GetServiceToolsGET https://hanhosting.com/api/v1/client/services/{id}/tools
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{
  "data": [
    { "key": "email-accounts", "group": "email", "label": "Email Accounts", "capabilities": ["create", "delete", "password", "quota"], "url": "" },
    { "key": "databases", "group": "database", "label": "Databases", "capabilities": ["create", "delete"], "url": "" }
  ]
}
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422not_actionableLe service n'est pas actif.
422tools_not_supportedLe 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.

Autorisation : Services/GetServiceToolDataGET https://hanhosting.com/api/v1/client/services/{id}/tools/{tool}
Paramètres de requête
ChampTypeDescription
toolobligatoirechaîneClé de l'outil (dans le chemin), p. ex. email-accounts
actionchaîneAction de lecture, index par défaut
Exemple de requête
curl -s "https://hanhosting.com/api/v1/client/services/1204/tools/email-accounts" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "data": { "accounts": [ { "email": "[email protected]", "quota": "1024", "used": "12.4" } ] } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
404not_foundL'outil n'existe pas ou n'est pas pris en charge.
500tool_data_failedLe 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.

Autorisation : Services/RunServiceToolActionPOST https://hanhosting.com/api/v1/client/services/{id}/tools/{tool}/{action}
Champs du corps de la requête (JSON)
ChampTypeDescription
toolobligatoirechaîneClé de l'outil (dans le chemin)
actionobligatoirechaîneAction (dans le chemin), p. ex. create, delete
…objetChamps 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.
Exemple de requête
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" }'
Exemple de réponse
HTTP 200
{ "data": { "status": "successful", "message": "Database created." } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422tools_not_supported, tool_rejectedLe service ne prend pas en charge cet outil, ou l'opération a été refusée.
500tool_action_failedLe 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.

Autorisation : Services/GetServiceSsoPOST https://hanhosting.com/api/v1/client/services/{id}/sso
Exemple de requête
curl -s -X POST "https://hanhosting.com/api/v1/client/services/1204/sso" \
  -H "Authorization: Bearer $HANHOSTING_API_KEY" \
  -H "Accept: application/json"
Exemple de réponse
HTTP 200
{ "data": { "url": "https://…/login?token=…" } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422sso_not_supportedLe panneau ne prend pas en charge la connexion en un clic.
500sso_failedL'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.

Autorisation : Services/ChangeServicePasswordPOST https://hanhosting.com/api/v1/client/services/{id}/password
Champs du corps de la requête (JSON)
ChampTypeDescription
passwordobligatoirechaîneNouveau 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.
Exemple de requête
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" }'
Exemple de réponse
HTTP 200
{ "data": { "changed": true, "service_id": 1204 } }
Erreurs propres à ce point de terminaison
HTTPCodeSignification
422password_not_supportedCe type de service ne permet pas de changer le mot de passe.
422password_too_shortLe mot de passe est trop court ; details.min indique la longueur minimale.
422password_change_failedLe 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).

Autorisation : Services/UpdateServicePATCH https://hanhosting.com/api/v1/client/services/{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.

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

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.

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

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}

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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.

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

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).

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

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.

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

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.

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

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.

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

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.

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

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é
Autorisation : Domains/GetTransferStatusGET https://hanhosting.com/api/v1/client/domains/{domain}/transfer-status

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é
Autorisation : Domains/GetNameserversGET https://hanhosting.com/api/v1/client/domains/{domain}/nameservers

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).

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

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é
Autorisation : Domains/GetChildNameserversGET https://hanhosting.com/api/v1/client/domains/{domain}/child-nameservers

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": "…"}

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

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é
Autorisation : Domains/DeleteChildNameserverDELETE https://hanhosting.com/api/v1/client/domains/{domain}/child-nameservers

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é
Autorisation : Domains/GetTransferLockGET https://hanhosting.com/api/v1/client/domains/{domain}/transfer-lock

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}

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

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é
Autorisation : Domains/SendAuthCodePOST https://hanhosting.com/api/v1/client/domains/{domain}/auth-code

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é
Autorisation : Domains/SaveAuthCodePUT https://hanhosting.com/api/v1/client/domains/{domain}/auth-code

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.

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

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}

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

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é
Autorisation : Domains/UpdateDnsRecordPUT https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

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é
Autorisation : Domains/DeleteDnsRecordDELETE https://hanhosting.com/api/v1/client/domains/{domain}/dns-records

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é
Autorisation : Domains/GetDnssecRecordsGET https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

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é
Autorisation : Domains/CreateDnssecRecordPOST https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

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é
Autorisation : Domains/DeleteDnssecRecordDELETE https://hanhosting.com/api/v1/client/domains/{domain}/dnssec

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é
Autorisation : Domains/GetWhoisContactsGET https://hanhosting.com/api/v1/client/domains/{domain}/whois

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é
Autorisation : Domains/UpdateWhoisContactsPUT https://hanhosting.com/api/v1/client/domains/{domain}/whois

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é
Autorisation : Domains/ApplyWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/{domain}/whois/apply

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é
Autorisation : Domains/UpdateWhoisPrivacyPUT https://hanhosting.com/api/v1/client/domains/{domain}/whois-privacy

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é
Autorisation : Domains/GetEmailForwardsGET https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

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é
Autorisation : Domains/CreateEmailForwardPOST https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

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é
Autorisation : Domains/DeleteEmailForwardDELETE https://hanhosting.com/api/v1/client/domains/{domain}/email-forwards

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é
Autorisation : Domains/GetUrlForwardingGET https://hanhosting.com/api/v1/client/domains/{domain}/forwarding

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}

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

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é
Autorisation : Domains/DeleteUrlForwardingDELETE https://hanhosting.com/api/v1/client/domains/{domain}/forwarding

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.

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

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é
Autorisation : Domains/GetWhoisProfilesGET https://hanhosting.com/api/v1/client/domains/whois-profiles

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é
Autorisation : Domains/CreateWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/whois-profiles

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é
Autorisation : Domains/UpdateWhoisProfilePUT https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}

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é
Autorisation : Domains/DeleteWhoisProfileDELETE https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}

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é
Autorisation : Domains/SetDefaultWhoisProfilePOST https://hanhosting.com/api/v1/client/domains/whois-profiles/{pid}/default

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é
Autorisation : Domains/GetDefaultNameserversGET https://hanhosting.com/api/v1/client/domains/default-nameservers

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é
Autorisation : Domains/UpdateDefaultNameserversPUT https://hanhosting.com/api/v1/client/domains/default-nameservers

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é
Autorisation : Addresses/GetAddressesGET https://hanhosting.com/api/v1/client/addresses

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.

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

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é
Autorisation : Addresses/GetAddressGET https://hanhosting.com/api/v1/client/addresses/{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.

PUT/addresses/{id}Modifier une adresse Désactivé
Autorisation : Addresses/UpdateAddressPUT https://hanhosting.com/api/v1/client/addresses/{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.

DELETE/addresses/{id}Supprimer une adresse Désactivé
Autorisation : Addresses/DeleteAddressDELETE https://hanhosting.com/api/v1/client/addresses/{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.

POST/addresses/{id}/defaultDéfinir comme adresse par défaut Désactivé
Autorisation : Addresses/SetDefaultAddressPOST https://hanhosting.com/api/v1/client/addresses/{id}/default

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é
Autorisation : Tickets/GetTicketDepartmentsGET https://hanhosting.com/api/v1/client/tickets/departments

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é
Autorisation : Tickets/GetTicketAccessGroupsGET https://hanhosting.com/api/v1/client/tickets/access-groups

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é
Autorisation : Tickets/GetTicketsGET https://hanhosting.com/api/v1/client/tickets

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.

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

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é
Autorisation : Tickets/GetTicketGET https://hanhosting.com/api/v1/client/tickets/{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.

POST/tickets/{id}/replyRépondre à un ticket Désactivé
Autorisation : Tickets/ReplyTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/reply

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é
Autorisation : Tickets/CloseTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/close

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é
Autorisation : Tickets/ReopenTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/reopen

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é
Autorisation : Tickets/RateTicketPOST https://hanhosting.com/api/v1/client/tickets/{id}/rating

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é
Autorisation : Tickets/RateTicketReplyPOST https://hanhosting.com/api/v1/client/tickets/{id}/replies/{rid}/rating

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é
Autorisation : Tickets/GetTicketAttachmentGET https://hanhosting.com/api/v1/client/tickets/{id}/attachments/{aid}

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é
Autorisation : Sms/GetSmsSendersGET https://hanhosting.com/api/v1/client/sms/senders

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é
Autorisation : Sms/QuoteSmsPOST https://hanhosting.com/api/v1/client/sms/quote

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.

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

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é
Autorisation : Sms/GetSmsMessagesGET https://hanhosting.com/api/v1/client/sms/messages

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é
Autorisation : Sms/GetSmsMessageGET https://hanhosting.com/api/v1/client/sms/messages/{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.

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é
Autorisation : Affiliate/GetAffiliateGET https://hanhosting.com/api/v1/client/affiliate

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é
Autorisation : Affiliate/GetAffiliateCommissionsGET https://hanhosting.com/api/v1/client/affiliate/commissions

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é
Autorisation : Affiliate/EnrollAffiliatePOST https://hanhosting.com/api/v1/client/affiliate/enroll

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é
Autorisation : Affiliate/WithdrawAffiliatePOST https://hanhosting.com/api/v1/client/affiliate/withdraw

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é
Autorisation : Affiliate/SaveAffiliatePayoutMethodPUT https://hanhosting.com/api/v1/client/affiliate/payment-method

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-Key sur chaque requête POST qui entraîne un mouvement d'argent.
  • Vérifiez le total avec POST /orders/preview avant 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.
Contact

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.