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
Programme revendeur HanHosting

Revendeur VDS : revente automatisée de VDS et d'hébergement par API.

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.

  • REST + JSONChaque point de terminaison est documenté avec un exemple de requête et de réponse.
  • Commande sur le soldePrévisualisez le montant, payez la commande sur votre solde.
  • Gestion des servicesRenouvellement, upgrade, demande de résiliation, rDNS, mot de passe et console VNC.
  • IP approuvées, clé à droits limitésL'API ne fonctionne que depuis les adresses IP approuvées de vos serveurs ; la clé ne dispose que des autorisations que vous lui accordez.
  • REST + JSON
  • Commande automatique sur le solde
  • Remise revendeur
  • Tickets d'assistance 24 h/24, 7 j/7
Revendeur VDS et hébergement – Revente automatisée par API
01Accès à l'API

Programme revendeur par API : pas d'offre à acheter, un accès direct à l'API

Le programme revendeur par API s'ouvre sur demande

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.

Contacter l'équipe d'assistance
02API revendeur

De la commande à la gestion du serveur

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.

  1. 01Liste des produits et des prix
  2. 02Commande et paiement des factures sur le solde
  3. 03Renouvellement, upgrade, résiliation et console VNC
03Exemples de scénarios

Les scénarios prêts à l'emploi de la documentation

Chaque étape est décrite dans la documentation avec des exemples de requêtes et de réponses.

01Commande

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
02Renouvellement

Renouvellement et paiement des factures

Repérez les services dont l'échéance approche, créez une facture de renouvellement et payez-la sur votre solde.

  • Consultez les périodes de renouvellement possibles
  • Créez une facture de renouvellement
  • Payez la facture sur le solde
03VNC

Console VNC du VDS

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.

  • Lisez l'état de la machine
  • Démarrez le serveur si nécessaire
  • Récupérez l'adresse de connexion à la console
04Ce que permet l'API

Votre activité de revendeur dans votre propre système

La plupart des opérations que vous faites à la main dans l'Espace client, vous les réalisez automatiquement depuis votre propre logiciel.

Liste des produits et des prix

Récupérez sur votre propre site les produits en vente, les catégories, les prix par période et les options de commande.

Commande sur le solde

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.

Factures et solde

Consultez vos factures et payez-les sur le solde ; suivez votre solde actuel et les mouvements de votre solde.

Renouvellement, upgrade et résiliation

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.

Outils serveur

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.

Accès sécurisé

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.

Sécurité

Votre clé reste sous votre contrôle

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.

  • L'API ne fonctionne que depuis les adresses IP approuvées de vos serveurs
  • La clé n'est affichée qu'une seule fois, au moment de sa création
  • Notre serveur conserve l'empreinte (hash) de la clé, pas la clé elle-même
  • Restriction IP supplémentaire au niveau de la clé (facultative)
  • Les requêtes restent visibles 30 jours dans les journaux
Modèle revendeur

L'infrastructure chez nous, la relation client chez vous

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.

05Premiers pas

Quatre étapes de la demande revendeur à la première commande

  1. 01

    Faites votre demande, déclarez votre IP

    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.

  2. 02

    Créez votre clé

    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.

  3. 03

    Testez la connexion

    Vérifiez avec GET /ping que vous atteignez l'API, puis avec GET /whoami que la clé est valide et quelles autorisations elle porte.

  4. 04

    Passez la première commande

    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.

06Guide du programme revendeur

Comment fonctionne la revente de VDS et d'hébergement par API ?

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.

01

Deux formules pour revendre des serveurs : le programme revendeur par API (VDS reseller) et l'hébergement revendeur

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.

  • Produit vendu : avec le programme par API, nos produits VDS et d'hébergement web ; avec l'hébergement revendeur, les offres cPanel que vous créez dans WHM.
  • Démarrage : le programme par API s'ouvre sur demande, après approbation de l'IP ; l'offre d'hébergement revendeur s'ouvre par une commande.
  • Paiement : avec le programme par API, chaque commande est débitée de votre solde avec la remise revendeur ; avec l'hébergement revendeur, vous payez le prix d'une seule offre.
  • Ressources : avec le programme par API, chaque service utilise les ressources de sa propre offre ; avec l'hébergement revendeur, 10, 25 ou 50 comptes selon l'offre se partagent le disque et le trafic totaux de l'offre.
  • Ce qu'il faut : pour le programme par API, un logiciel qui appelle l'API ; pour l'hébergement revendeur, les écrans de WHM suffisent.
02

À qui s'adresse la revente d'hébergement par API ?

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.

  • Hébergeurs : ceux qui veulent vendre des VDS sur leur propre site et transmettre automatiquement les commandes à HanHosting.
  • Agences disposant d'un logiciel : celles qui veulent relier à leur propre système de gestion l'ouverture et le renouvellement de serveurs pour les projets de leurs clients.
  • Développeurs de panneaux : ceux qui veulent intégrer la console VNC du VDS et les outils du service à leur propre interface.
  • Si vous ne comptez pas développer de logiciel, l'hébergement revendeur pour vendre de l'hébergement, ou les offres de serveur VDS ou d'hébergement web pour votre propre usage, sont plus simples.
03

Vendre des VDS par API : du paiement à la livraison

Le scénario de commande de la documentation automatise, dans l'ordre suivant, le moment où votre client vous achète un VDS :

  • Votre logiciel lit dans le détail du produit les périodes, les choix obligatoires et les services supplémentaires.
  • Le point de terminaison de prévisualisation (POST /orders/preview) calcule le total, coupon et taxes compris, sans créer de commande.
  • La 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.
  • Lorsque l'état du service passe à 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.

04

Remise revendeur, solde et prix de vente

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.

05

Renouvellement, upgrade et services échus

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

06

Ce que vous pouvez proposer à votre client depuis votre propre panneau

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 :

  • Connexion au panneau en un clic : une adresse de courte durée, avec session déjà ouverte, pour cPanel ou le panel de jeu.
  • Changement de mot de passe : pour les services d'hébergement et de serveur.
  • Outils du service : sur l'hébergement web, par exemple compte e-mail, base de données, enregistrement DNS ou tâche cron ; les outils varient selon le panneau auquel le service est rattaché.
  • Console VNC : une adresse à usage unique qui donne accès à l'écran du VDS même si RDP ou SSH ne fonctionnent pas ; elle s'intègre à votre panneau avec un client comme noVNC.
  • DNS inverse (rDNS) : sur les adresses IP prises en charge.
  • Demande de résiliation : ouverture et annulation.
07

Intégration : API REST et documentation

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.

08

Sécurité : liste d'adresses IP autorisées et conservation de la clé

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.

  • La clé n'est affichée qu'une seule fois, au moment de sa création ; conservez-la dans une variable d'environnement ou dans un coffre-fort de secrets.
  • Ne placez pas la clé dans du code exécuté par le navigateur, dans une application mobile ni dans un dépôt public ; utilisez-la uniquement côté serveur.
  • Attribuez une clé distincte à chaque intégration et ne cochez que les autorisations nécessaires.
  • Conservez sous forme chiffrée les mots de passe de service renvoyés par l'API et ne les écrivez pas dans les fichiers journaux.
  • Si vous soupçonnez une fuite, révoquez immédiatement la clé ou régénérez-la.
09

Assistance et responsabilités : qui fait quoi ?

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.

07Questions fréquentes

Questions fréquentes sur la revente de VDS et l'API

Comment fonctionne la revente de VDS ?

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

Pour revendre de l'hébergement, faut-il choisir le programme revendeur par API ou l'hébergement revendeur ?

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.

Y a-t-il une remise revendeur, et est-ce moi qui fixe mon prix de vente ?

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.

Comment faire une demande pour devenir revendeur ?

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

Quelles opérations sont possibles pour la vente de VDS par API ?

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.

Comment la commande est-elle payée, et que se passe-t-il si mon solde est insuffisant ?

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.

Puis-je appeler l'API depuis n'importe quelle adresse IP ?

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.

Les opérations sur les noms de domaine sont-elles possibles par API ?

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.

Faut-il des connaissances techniques ?

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.

Que se passe-t-il si l'échéance de renouvellement d'un service que j'ai vendu est dépassée ?

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.

Qui assure l'assistance de mes clients ?

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.

Puis-je faire passer à une offre supérieure un VDS que j'ai vendu en tant que revendeur ?

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.

API revendeur HanHosting

Créez votre propre activité d'hébergement grâce à l'API

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.

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.