Si vous revendez des produits Infomaniak (hebergement, kSuite, VPS, domaines...) a vos propres clients, automatiser la recuperation de vos produits vous fait gagner un temps precieux chaque mois. C'est exactement le role de l'API Infomaniak.
Ce qu'il faut savoir avant de commencer
L'API Infomaniak est une API REST : les requetes et reponses sont encodees en JSON, et l'authentification se fait via un jeton Bearer. Concretement, chaque appel ressemble a ceci :
curl --location --request GET 'https://api.infomaniak.com/1/products' \
--header 'Authorization: Bearer VOTRE_JETON'
Limite a connaitre : l'API Infomaniak est plafonnee a 60 requetes par minute. Largement suffisant pour une synchronisation reguliere de votre parc de produits.
Etape 1 : generer un jeton API
- Connectez-vous a votre Manager Infomaniak.
- Cliquez sur Creer un jeton.
- Choisissez le produit/l'application concernee et la duree de validite.
- Copiez immediatement le jeton : il ne sera plus jamais affiche par la suite.
Etape 2 : verifier la connexion
Le point d'entree le plus simple pour tester votre jeton est /profile, qui renvoie les informations de votre compte :
curl --location --request GET 'https://api.infomaniak.com/profile' \
--header 'Authorization: Bearer VOTRE_JETON'
Dans Infofac, ce test est disponible en un clic depuis la page Configuration > Connexion API.
Etape 3 : lister vos produits
L'endpoint /1/products renvoie l'ensemble des produits et services pour lesquels votre compte dispose d'au moins un droit : hebergements, licences kSuite, VPS, domaines, etc.
curl --location --request GET 'https://api.infomaniak.com/1/products' \
--header 'Authorization: Bearer VOTRE_JETON'
C'est exactement ce que fait le bouton Synchroniser avec Infomaniak dans Infofac : il importe chaque produit renvoye par l'API dans votre parc, pret a etre associe a un client et a recevoir un prix de vente.
Bonnes pratiques
- Ne partagez jamais votre jeton API, il donne acces a votre compte Infomaniak.
- Revoquez immediatement un jeton si vous soupconnez une fuite.
- Limitez le perimetre (scope) du jeton aux produits dont vous avez reellement besoin.
Une fois votre jeton connecte, vous n'avez plus qu'a definir vos prix de vente pour que vos marges se calculent automatiquement.