Skip to main content

Clés API

ODOIP met à votre disposition un espace self-service pour créer et révoquer vos clés d’API. Ces clés vous permettent de piloter la voix par programmation, c’est-à-dire d’intégrer nos services de téléphonie directement dans vos propres applications et outils.

Où gérer vos clés ?

La gestion de vos clés d’API se fait dans la rubrique Mon API du panneau de gestion de la téléphonie (switch), accessible depuis votre espace client (https://odoip.com/clientarea.php).

À quoi sert une clé d’API ?​

Une clé d’API est un identifiant secret qui authentifie vos requêtes auprès de nos points d’entrée. Elle vous permet, par exemple, d’automatiser certaines opérations voix depuis vos propres systèmes, sans passer par l’interface web.

Une documentation interactive des points d’entrée est disponible pour vous aider à tester et à intégrer l’API. Pour démarrer, consultez la page Introduction à l’API Voix.

Créer une clé d’API​

Depuis la rubrique Mon API du panneau de gestion de la téléphonie (switch), accessible depuis votre espace client :

  1. Ouvrez la rubrique Mon API.
  2. Lancez la création d’une nouvelle clé.
  3. Copiez immédiatement la clé générée et conservez-la en lieu sûr.
Conservez votre clé dès sa création

Pour des raisons de sécurité, une clé n’est généralement affichée en entier qu’au moment de sa création. Copiez-la et stockez-la dans un emplacement sécurisé, car vous ne pourrez pas toujours la récupérer par la suite.

Révoquer une clé d’API​

Si une clé n’est plus utilisée, ou si vous pensez qu’elle a été exposée, révoquez-la sans attendre depuis le même espace. Une clé révoquée cesse immédiatement de fonctionner et ne peut plus authentifier aucune requête.

Bonnes pratiques de sécurité​

  • Ne partagez jamais vos clés par courriel, message instantané ou dépôt de code public.
  • Ne stockez pas vos clés en clair dans votre code source : utilisez des variables d’environnement ou un gestionnaire de secrets.
  • Créez une clé distincte par application ou par usage, afin de pouvoir en révoquer une sans affecter les autres.
  • Révoquez immédiatement toute clé exposée ou compromise, puis générez-en une nouvelle.
Renforcez la protection de vos accès

En complément des bonnes pratiques sur les clés, vous pouvez restreindre l’accès d’administration par liste d’adresses IP autorisées. Consultez la page Sécurité des accès.

Besoin d’aide ?​

Pour toute question sur vos clés d’API ou sur l’intégration de l’API Voix, connectez-vous à votre espace client (https://odoip.com/clientarea.php) et contactez notre équipe support. Nous restons à votre disposition.