Documentation produit

Les produits InterCloud exposent des API REST sous le chemin /api/v1. Le portail et les interfaces des produits utilisent ces mêmes API, appelées depuis le navigateur sur la même origine : tout ce que l’interface utilisateur permet de faire est donc accessible à une intégration disposant des autorisations appropriées. Les requêtes et les réponses sont au format JSON sur HTTPS.

L’accès programmatique utilise des clés API, gérées par les Propriétaires et Administrateurs dans Paramètres → Développeur. Une clé ne s’affiche qu’une seule fois, à sa création, puis n’est stockée que sous forme de hachage : elle doit donc être copiée dans votre coffre de secrets à ce moment-là. Les clés peuvent être désactivées et révoquées immédiatement. Les sessions de navigateur utilisent un cookie HttpOnly avec un en-tête CSRF sur les requêtes qui modifient des données ; le portail s’en charge, et cela ne s’applique pas aux appels par clé API.

Quelques points de terminaison publics ne nécessitent aucune authentification : l’inscription à la newsletter (avec double opt-in par e-mail) et les demandes de contact depuis le site web. Tout le reste nécessite une session ou une clé API et est soumis à des limites de débit par espace de travail ; en cas de dépassement, l’API renvoie une réponse standard « trop de requêtes » indiquant quand réessayer.

Les spécifications OpenAPI détaillées de chaque produit sont fournies aux clients sur demande lors de leur intégration, avec un accès à un environnement de test (sandbox). Contactez votre équipe commerciale ou le support pour les obtenir.