Détails techniques
Votre Account Vonage peut être géré de différentes manières :
- Par l'intermédiaire de la Tableau de bord
- L'utilisation de la CLI (interface de ligne de commande)
- En appelant le API directement ou avec l'un des SDK du serveur Vonage pour votre pile technologique préférée
Au sein de votre Account, vous pouvez vérifier votre solde, configurer les paramètres au niveau du compte et effectuer une rotation de vos secrets API à des fins de sécurité.
L'architecture globale est illustrée dans le diagramme suivant :

Chacun des principaux éléments du diagramme est expliqué plus en détail dans les sections suivantes.
Account
Représente une relation entre les clients et Vonage. Chaque Account est identifié par une clé API unique (account Id) et contient le solde, les paramètres, les rapports et les journaux de l'utilisation de l'API de Vonage.
Subaccounts
Chaque Account peut être associé à un ou plusieurs Subaccounts. Cette division vous permet de créer une structure hiérarchique pour faciliter la gestion de la configuration des produits, des rapports et de la facturation.
Un compte divisé en sous-comptes est appelé compte principal, tandis que les sous-comptes sont considérés comme étant collectivement détenus et contrôlés par le compte principal. Un seul niveau de hiérarchie est autorisé, de sorte que les sous-comptes ne peuvent pas avoir leurs propres sous-comptes.
Utilisateur principal
A utilisateur principal est créé lors de la création d'un compte Vonage. Il ne peut y avoir qu'un seul utilisateur principal pour le compte et ses Subaccounts. Un utilisateur principal peut inviter d'autres personnes à s'inscrire en tant que membres de l'équipe. Un utilisateur principal définit les droits de gestion et de surveillance des nouveaux membres de l'équipe et des comptes/sous-comptes qu'ils gèrent.
Membre de l'équipe
Un membre de l'équipe, anciennement appelé utilisateur secondairereprésente un utilisateur qui gère et configure un ou plusieurs Account par l'intermédiaire de l'application Tableau de bord. Les membres de l'équipe disposent d'un nom d'utilisateur et d'un mot de passe pour se connecter à l'application Tableau de bordet différents ensembles de permissions pour définir ce qu'ils peuvent gérer via le tableau de bord.
Secret de l'API
Pour effectuer un appel API avec les API REST de Vonage, une clé API (ID de compte) est nécessaire, ainsi qu'un secret API associé. Vonage vérifie que le secret est correct et facture le compte identifié par la clé API.
Guides
- Comment migrer de Pricing API v1 à Pricing API v2 ?: Comment migrer votre application de l'API Pricing v1 vers la nouvelle API Pricing v2.
- Paiements: Gérer les paiements, activer le rechargement automatique du compte et recevoir des notifications de solde
- Tableau de bord du compte Vonage: Comment utiliser le tableau de bord de Vonage
Extraits de code
Des extraits de code montrent comment utiliser l'API pour effectuer diverses tâches.
- Configuration du compte
- Créer un secret
- Liste de tous les secrets
- Obtenir le solde du compte
- Recherche d'un secret
- Révoquer un secret