Commande automatique sur votre solde
Lorsque votre client vous achète une offre, commandez automatiquement la même offre chez nous.
- Lisez le produit et ses options
- Prévisualisez le montant
- Payez la commande sur votre solde
Pour revendre des VDS et de l'hébergement, connectez votre site ou votre panneau à HanHosting par API : récupérez les produits et les prix, commandez sur votre solde avec la remise revendeur, payez les factures et gérez les services de vos clients depuis votre propre système.
Avec cette formule, vous n'achetez pas d'offre. Dans un ticket d'assistance, indiquez que vous souhaitez travailler comme revendeur et précisez l'adresse IP de sortie du serveur qui appellera l'API ; votre taux de remise revendeur est fixé lors de votre demande. Une fois votre IP approuvée et l'accès activé, vous créez vous-même votre clé depuis l'Espace client. Si vous voulez ouvrir des comptes cPanel avec WHM, consultez les offres d'hébergement revendeur.
Chaque commande que vous passez est créée sur votre compte HanHosting et payée sur votre solde, remise revendeur déduite ; c'est vous qui décidez du prix de vente à votre client.
Chaque étape est décrite dans la documentation avec des exemples de requêtes et de réponses.
Lorsque votre client vous achète une offre, commandez automatiquement la même offre chez nous.
Repérez les services dont l'échéance approche, créez une facture de renouvellement et payez-la sur votre solde.
Accédez à l'écran de la machine même si la connexion réseau, RDP ou SSH ne fonctionnent pas ; intégrez la console à votre propre panneau.
La plupart des opérations que vous faites à la main dans l'Espace client, vous les réalisez automatiquement depuis votre propre logiciel.
Récupérez sur votre propre site les produits en vente, les catégories, les prix par période et les options de commande.
Prévisualisez d'abord le montant de la commande, puis créez la commande et payez-la sur votre solde ; listez vos commandes enregistrées.
Consultez vos factures et payez-les sur le solde ; suivez votre solde actuel et les mouvements de votre solde.
Listez vos services, créez une facture de renouvellement, passez à une offre supérieure de la même gamme (la facture de différence est payée sur le solde), ouvrez une demande de résiliation ou annulez-la.
Utilisez le tableau de bord du service et ses outils : console VNC pour les VDS, changement de mot de passe, enregistrement DNS inverse (rDNS) sur les adresses IP prises en charge et connexion au panneau en un clic.
L'API n'est accessible que depuis les adresses IP de serveurs que vous avez déclarées à l'avance et fait approuver ; la clé ne dispose que des autorisations que vous lui accordez et peut, si vous le souhaitez, être en plus verrouillée sur une seule IP. Chaque requête est enregistrée sous forme masquée.
Vous créez vous-même votre clé API depuis l'Espace client, vous choisissez ses autorisations et vous la révoquez quand vous le voulez.
Le matériel, le réseau et la virtualisation sont à notre charge. Les services sont créés sur votre compte HanHosting et facturés avec la remise revendeur ; le prix de vente à vos clients et la relation client vous appartiennent.
Par ticket d'assistance, indiquez que vous souhaitez travailler comme revendeur et précisez l'adresse IP de sortie du serveur qui appellera l'API. Une fois l'IP approuvée, l'accès à l'API est activé sur votre compte.
Dans l'Espace client, créez une clé depuis la section « Identifiants API » ; ne sélectionnez que les autorisations nécessaires et, si vous le souhaitez, verrouillez en plus la clé sur l'adresse IP de votre serveur.
Vérifiez avec GET /ping que vous atteignez l'API, puis avec GET /whoami que la clé est valide et quelles autorisations elle porte.
Alimentez le solde ; à l'aide des exemples curl, PHP, Node.js et Python de la documentation, prévisualisez le montant puis passez la commande sur votre solde.
Chez HanHosting, ceux qui cherchent à revendre des serveurs ont le choix entre deux formules distinctes. Nous expliquons ci-dessous, dans l'ordre, à qui s'adresse le programme revendeur par API, comment se déroule une commande, les règles de solde et de remise, la sécurité et la différence avec l'hébergement revendeur, qui fonctionne avec WHM.
Avec le programme revendeur par API, le site de vente, l'inscription des clients et l'encaissement sont de votre côté. Lorsque votre client vous achète un VDS ou un hébergement, votre logiciel commande le même produit par API sur votre compte HanHosting ; le service est créé sur votre compte, et c'est vous qui transmettez les accès à votre client.
L'hébergement revendeur (WHM reseller hosting) est un produit distinct : vous prenez une offre revendeur et vous ouvrez un compte cPanel pour chacun de vos clients depuis le panneau WHM.
Le programme revendeur par API s'adresse à ceux qui gèrent la vente et la relation client dans leur propre système, mais ne veulent pas s'occuper du matériel ni du réseau.
Le scénario de commande de la documentation automatise, dans l'ordre suivant, le moment où votre client vous achète un VDS :
POST /orders/preview) calcule le total, coupon et taxes compris, sans créer de commande.POST /orders) est envoyée pour être payée sur le solde ; si le solde est suffisant, la facture est payée au même moment et le service entre dans la file d'installation.active, les accès figurent dans le détail du service ; vous les transmettez à votre client.Pour éviter qu'une même commande soit créée deux fois en cas de coupure réseau, ajoutez à la requête un en-tête Idempotency-Key généré à partir de votre propre numéro de commande. Envoyez la notification de livraison en fonction de l'état du service, et non d'un délai fixe.
Tous les paiements effectués par API sont débités du solde de votre compte ; vous alimentez le solde depuis la section « Solde du compte » de l'Espace client. Si le solde est insuffisant, la commande n'est pas créée du tout et l'API renvoie l'erreur insufficient_balance ; gardez une marge sur le solde en fonction de votre rythme de vente.
Votre taux de remise revendeur est fixé lors de votre demande ; il est déduit du montant des commandes et de la facture de différence lors des passages à une offre supérieure. Dans le détail de la facture, la remise revendeur apparaît séparément de la remise par coupon. C'est vous qui fixez votre prix de vente : prenez le montant renvoyé par la prévisualisation comme base de coût, puis ajoutez-y le temps que vous consacrerez à l'assistance et vos frais d'encaissement. Les montants des produits, des commandes et des prévisualisations sont exprimés dans la devise de votre solde ; au lieu de saisir votre liste de prix à la main, actualisez-la régulièrement depuis l'API.
Les services que vous vendez se trouvant sur votre compte, leur renouvellement vous incombe aussi. Vous repérez les services dont l'échéance approche grâce à la date d'échéance de la liste des services, vous créez la facture de renouvellement par API et vous la payez sur votre solde. Un service échu est suspendu ; s'il n'est pas payé sous 2 jours, il est résilié et supprimé avec ses données. Encaissez le paiement de votre client avant cette échéance.
Vous pouvez faire passer un service à une offre supérieure de la même gamme par API ; le point de terminaison des options d'upgrade indique les choix possibles et le montant. Pour changer de gamme, adressez-vous à l'équipe d'assistance, et faites une sauvegarde avant tout upgrade. Les services étant installés automatiquement, aucun remboursement n'est effectué ; seule exception : les commandes qui n'ont pas pu être installées pour une raison imputable au fournisseur (politique de remboursement et de résiliation).
Les services se trouvant sur votre compte, vous pouvez proposer depuis votre propre interface, grâce aux points de terminaison des services, les opérations dont votre client a souvent besoin. Les actions des outils effectuent de vraies modifications dans le panneau :
L'API fonctionne sous l'adresse https://hanhosting.com/api/v1/client ; les requêtes se font uniquement en HTTPS, le corps et les réponses sont en JSON. La clé est envoyée dans l'en-tête Authorization: Bearer ou, si votre serveur ne transmet pas cet en-tête, dans X-Api-Key. En cas d'erreur, votre programme doit décider en fonction du champ error.code.
La documentation de l'API décrit chaque point de terminaison ouvert à l'utilisation, avec ses paramètres, un exemple de réponse et les erreurs possibles. La limite par défaut est de 60 requêtes par minute et par clé ; au lieu d'interroger les listes de produits et de services à chaque ouverture de page, gardez-les brièvement en cache. Les points de terminaison des noms de domaine, des tickets d'assistance, des SMS et du programme d'affiliation sont actuellement fermés.
L'API revendeur n'est accessible que depuis les adresses IP de serveurs que vous avez déclarées et que HanHosting a approuvées. Lors de votre demande, vous indiquez l'adresse IP de sortie du serveur qui appellera l'API ; si le serveur ou l'IP doit changer, communiquez la nouvelle adresse à l'avance par ticket d'assistance. Une requête provenant d'une adresse absente de la liste est rejetée avec 403 ip_not_allowed. En plus de cela, vous pouvez verrouiller la clé sur des adresses IP précises ; la correspondance doit être exacte, et il n'est pas possible d'indiquer une plage CIDR.
Le matériel, le réseau et la virtualisation sont à notre charge : les serveurs fonctionnent dans le centre de données Datacasa à Istanbul, et la protection DDoS est assurée au niveau du réseau par les infrastructures de filtrage StormWall et OVH. La relation client, le prix, l'encaissement et l'assistance de premier niveau auprès de votre client sont à votre charge.
En cas de problème lié à l'infrastructure, contactez-nous par ticket d'assistance depuis l'Espace client (24 h/24, 7 j/7), par WhatsApp, sur Discord ou via le chat en direct du site ; indiquez dans le ticket le numéro du service, l'heure de la requête et le code d'erreur renvoyé. Le téléphone (+90 850 303 07 52) répond aux questions commerciales, de facturation et de compte du lundi au vendredi, 09:00–18:00 (heure de Turquie, UTC+3). Sur les VDS, le système d'exploitation, le pare-feu et les sauvegardes relèvent de la responsabilité de celui qui utilise le service ; la sauvegarde automatique n'est pas incluse.
Votre site ou votre panneau se connecte à HanHosting par API. Lorsque votre client vous achète un VDS ou un hébergement, votre logiciel commande le même produit chez nous via votre compte, et le montant est débité de votre solde avec la remise revendeur. Si vous voulez ouvrir des comptes cPanel pour vos propres clients avec WHM, nous proposons pour cela, séparément, nos offres d'hébergement revendeur (reseller hosting).
Avec le programme revendeur par API, vous vendez automatiquement sur votre propre site les produits VDS et d'hébergement de HanHosting ; chaque commande devient un service distinct sur votre compte, et il faut un logiciel. Avec l'hébergement revendeur, vous prenez une offre WHM et vous ouvrez vous-même les comptes cPanel de vos clients. Si vous comptez vendre des VDS, la voie à suivre est le programme par API.
Oui. Votre taux de remise est fixé lors de votre demande d'adhésion au programme revendeur ; il est déduit du montant de la commande et de la facture de différence en cas d'upgrade. Vous voyez le montant à payer avant la commande grâce au point de terminaison de prévisualisation. Le prix auquel vous vendez à votre client ne dépend que de vous.
Ouvrez un ticket d'assistance depuis l'Espace client ; indiquez que vous souhaitez travailler comme revendeur et précisez l'adresse IP de sortie du serveur qui appellera l'API. Une fois votre IP approuvée et l'accès activé, la page « Identifiants API » apparaît et vous créez vous-même votre clé.
Liste des produits et des prix, prévisualisation du montant, commande sur le solde, consultation des factures et paiement sur le solde, mouvements du solde, liste et détail des services, renouvellement, passage à une offre supérieure de la même gamme, demande de résiliation, DNS inverse, changement de mot de passe, connexion au panneau en un clic et console VNC pour les VDS.
Les commandes passées et les factures payées par API sont débitées du solde de votre compte ; vous alimentez le solde depuis l'Espace client. Si le solde est insuffisant, la commande n'est pas créée et l'API renvoie l'erreur insufficient_balance.
Non. L'API ne fonctionne que depuis les adresses IP de serveurs que vous avez déclarées et qui ont été approuvées ; les requêtes provenant d'autres adresses sont rejetées. Si votre serveur ou votre IP doit changer, communiquez la nouvelle adresse à l'avance par ticket d'assistance. La restriction IP de la clé est une restriction facultative qui s'ajoute à celle-ci.
Pas pour le moment ; les points de terminaison des noms de domaine sont fermés. Pour les opérations sur les noms de domaine, utilisez l'Espace client.
Il faut des connaissances en développement suffisantes pour travailler avec une API REST ; la documentation contient des exemples curl, PHP, Node.js et Python. Si vous voulez vendre de l'hébergement sans écrire de code, l'hébergement revendeur, qui fonctionne avec WHM, convient mieux.
Le service se trouvant sur votre compte, la responsabilité du paiement vous revient. Un service échu est suspendu ; s'il n'est pas payé sous 2 jours, il est résilié et supprimé avec ses données. Créez la facture de renouvellement par API et payez-la sur votre solde.
Vos clients s'adressent à vous. Un problème lié à l'infrastructure, c'est vous qui nous le transmettez par ticket d'assistance 24 h/24, 7 j/7, par WhatsApp, sur Discord ou via le chat en direct. Les points de terminaison de l'API pour les tickets d'assistance étant fermés, les tickets s'ouvrent depuis l'Espace client.
Oui, vous pouvez passer par API aux offres supérieures de la même gamme ; la facture de différence est payée sur votre solde, remise revendeur déduite. Pour changer de gamme, adressez-vous à l'équipe d'assistance ; faites une sauvegarde avant l'upgrade.
Consultez la documentation, écrivez à notre équipe d'assistance pour obtenir l'accès à l'API et passez votre première commande depuis votre propre système.
Une question avant d'acheter, ou besoin d'aide pour un compte existant ? Appelez-nous ou écrivez-nous par e-mail.