Vue d’utilisation de l’API

Conditions préalables
  • Oauth > client > Vue autorisation

La vue Utilisation de l’API vous permet de voir combien de API demande votre centre de contact fait et quels clients font ces demandes. Si vous dépassez le Politique d’utilisation équitable des API, ces informations peuvent aider à déterminer quels clients font le plus de demandes et quel type de demande votre organisation utilise le plus souvent. Vous pouvez utiliser ces informations pour rationaliser votre utilisation de l’API et éviter ou planifier des dépassements.  

Les données de cette vue incluent tous les appels PUT, POST, GET ou DELETE effectués à partir de votre organisation à l’appui d’applications, d’intégrations et de solutions personnalisées ou troisièmes participant, y compris applications AppFoundry. Il inclut également des actions de données à l’API publique PureCloud.

Cette vue n’inclut pas les données sur les demandes d’API que PureCloud effectue pour prendre en charge la fonction de ses applications navigateur, Web et mobiles ou des actions de données sortantes vers des plates-formes externes. Il n’inclut pas non plus les demandes d’API PureCloud Clients intégrés, y compris PureCloud pour Chrome, PureCloud pour Firefox, PureCloud pour Salesforce et PureCloud pour Zendesk.

PureCloud calcule quotidiennement les données d’utilisation de l’API, en tant qu’agrégat de toutes les demandes d’API effectuées entre 00 :00 :00 et 23 :59 :59. Ce calcul est conforme à la norme de temps UTC et en conformité avec PureCloud facturation.

Pour afficher la vue de l'utilisation de l'API, cliquez sur Performance >Workspace > Other > API Usage. Cette vue n’inclut pas de données pour la journée en cours.

Remarque : Pour afficher plus d'informations sur le rapport d'utilisation de l'API disponible dans l'interface utilisateur d'administration, consultez Rapport d'utilisation de l'API.

Calculs de données d’utilisation aPI

Pour faciliter l’utilisation, l’affichage de l’affichage de la demande d’API par API affiche les dates de demande d’API dans votre fuseau horaire local. Dans certains cas, l’ajustement de UTC à votre local fuseau horaire signifie que la date d’une demande d’API, telle que représentée dans la vue utilisation de l’API, peut différer de la date à laquelle la demande a été faite, selon le fuseau horaire local du client.

Interpréter la vue

La vue contient un graphique et deux sections principales : Clients OAuth et demandes d’API. Chaque section comporte des colonnes de données relatives au client ou à la demande spécifique. 

Graphique de données

Le graphique affiche toutes les demandes d’API pour la période de temps sélectionnée, même si vous avez des filtres appliqués aux sections Client OAuth et API Request. Toutefois, le graphique n’affiche pas de données lorsque vous sélectionnez un jour comme plage de date.

Pour plus d’informations sur les données, survolez les barres du graphique. le au-dessus d’une barre représente le plus grand montant pour cette période, et le représente le montant le plus bas.

Clients OAuth

La section clients d’OAuth affiche une liste de clients qui ont fait des demandes d’API au cours de la période sélectionnée. Ces clients comprennent des applications, des intégrations et des solutions personnalisées ou troisièmes participant, y compris applications AppFoundry. Cliquez sur un client pour mettre en évidence les demandes faites par ce client dans la section Demandes aPI. 

Demandes API

La section Demandes aPI affiche une liste de tous les appels PUT, POST, GET ou DELETE effectués par les clients OAuth. Cliquez sur une demande d’API pour mettre en évidence les clients qui ont fait la demande. 

Colonnes de section

Par par défaut, chaque section comporte quatre colonnes :

  • une liste de clients ou de demandes d’API pour cette section particulière
  • le nombre de demandes du client ou de l’API point de terminaison
  • le pourcentage de demandes pour le client ou à l’API point de terminaison
  • une représentation visuelle du pourcentage de demandes par rapport au nombre total de demandes
Exemple Colonne Description
Cliquez sur l’image pour l’agrandir.API Afficher la colonne de nom d’utilisation Demande de client ou d’API d’OAuth Le client OAuth spécifique qui fait des demandes d’API ou la demande spécifique d’API que votre organisation a faite. 
Cliquez sur l’image pour l’agrandir.API Utilisation afficher le nombre de demandes de la colonne Nombre de demandes Le nombre de demandes que le client Dauth a faites ou le numéro d’une demande d’API spécifique que votre organisation a faite. 
Cliquez sur l’image pour l’agrandir.API Utilisation afficher Pourcentage de la colonne des demandes Pourcentage de demandes

Le pourcentage de demandes que le client d’OAuth a faites ou le nombre d’une demande d’API spécifique que votre organisation a faite, lié au nombre total de demandes.

Cliquez sur l’image pour l’agrandir.API Utilisation afficher la colonne de représentation visuelle Représentation visuelle Représentation visuelle du pourcentage de demandes. 

Si vous cliquez sur un client ou si vous demandez à filtrer les données, une autre colonne s’affiche entre les colonnes de nombre et de pourcentage. Cette nouvelle colonne affiche le pourcentage de demandes qui correspondent au filtre lié au nombre total de demandes. Si aucune demande ne correspond au filtre de demande sélectionné, la vue n’affiche pas de pourcentage filtré. 

Lorsque vous filtrez, les autres colonnes mettent à jour pour correspondre au filtre :

  • La liste des clients ou des demandes d’API met en évidence la demande de client ou d’API que vous avez cliqué.
  • Le nombre de requêtes change pour afficher le nombre de demandes qui correspondent au filtre. Si aucune demande ne correspond au filtre, le nombre devient gris. 
  • Le pourcentage total de demandes devient gris.
  • La représentation visuelle passe d’une barre solide à une barre divisée pour afficher à la fois le pourcentage de demandes qui correspondent au filtre et le pourcentage de demandes totales. Toute différence entre les deux pourcentages apparaît comme une partie grise de la barre. 
Exemple Colonne Description

Cliquez sur l’image pour l’agrandir.

API Utilisation afficher la colonne de demande filtrée

Demande de client ou d’API d’OAuth Le client OAuth spécifique qui fait des demandes d’API ou la demande spécifique d’API que votre organisation a faite. La vue met en évidence la ligne que vous cliquez pour filtrer par. 
Cliquez sur l’image pour l’agrandir.API Utilisation afficher le nombre filtré de la colonne des demandes Nombre de demandes

Le nombre de demandes que le client Dauth a faites ou le numéro d’une demande d’API spécifique que votre organisation a faite. Si aucun appel ne correspond au filtre de motif sélectionné, le nombre reste identique au nombre total d’appels correspondant au motif, mais il apparaît en grisé. 

Cliquez sur l’image pour l’agrandir.API Utilisation afficher des colonnes de pourcentage filtrées Pourcentage de demandes filtrées

Lorsque vous cliquez sur un client ou que vous demandez à filtrer des données, cette colonne s’affiche et affiche le pourcentage de demandes qui correspondent au client filtré ou à la demande liée au nombre total de demandes. Si aucune demande ne correspond au filtre sélectionné, la vue n’affiche pas de pourcentage filtré.

Cliquez sur l’image pour l’agrandir.API Utilisation afficher le pourcentage total filtré de la colonne des demandes Pourcentage de demandes Le pourcentage de demandes que le client d’OAuth a faites ou le nombre d’une demande d’API spécifique que votre organisation a faite, lié au nombre total de demandes.
Cliquez sur l’image pour l’agrandir.API Utilisation afficher la colonne de représentation visuelle filtrée Représentation visuelle

Représentation visuelle du pourcentage de demandes correspondant au filtre et du pourcentage de demandes totales. Toute différence entre les deux pourcentages apparaît comme une partie grise de la barre. 

Remarque :  Vous pouvez filtrer par un client OAuth ou une demande d’API à la fois. Si vous cliquez sur un autre client ou une demande, le filtre change à ce client ou à cette demande.

Personnaliser la vue

Personnalisez la vue pour afficher uniquement certaines données. À sauvegarder votre filtre et les paramètres de date pour la vue, cliquez sur sauver. 

Remarque :  note: Vous ne pouvez pas afficher les données pour la journée en cours. Aucune plage de date n’inclut les données pour la journée en cours.

Utilisez le filtre de date pour personnaliser les vues analytique.

Utilisez des préréglages pour filtrer les métriques par date, ou configurer une plage de dates personnalisée.

Pour utiliser un préréglage pour filtrer les métriques, effectuez les étapes suivantes :

  1. Cliquez sur la date pour afficher le filtre de date.
  2. Sous KEY DATE, sélectionnez Transcript Start ou Conversation Start.
  3. Dans la liste des préréglages, sélectionnez une option date prédéfinie.

Préréglages de date

Préconfigurations Description
Intervalle actuel

Affiche les données de la période actuelle de 30 minutes.

Remarque :  Parce que les vues de détail incluentIntervalle dans la grille de données,intervalle actuel le préréglage n’est pas affiché pour ces vues.

Début de la transcription

Trie les résultats de la recherche en fonction du moment où la transcription commence.

Début de conversation

Trie les résultats de la recherche en fonction du moment où la conversation commence.
Aujourd'hui Affiche les données pour la période qui inclut l’intervalle actuel.
Hier Affiche les données de la veille.
Cette semaine Affiche les données pour une période allant du dimanche au samedi.
La semaine dernière Affiche les données de la semaine précédente, du dimanche au samedi.
7 jours précédents Affiche les données des sept jours précédents.
Ce mois-ci Affiche les données du mois en cours, sans jours supplémentaires.
Ce mois par semaine Affiche les données du mois civil en cours commençant le dimanche et se terminant le samedi, y compris les jours supplémentaires si le mois ne commence pas le dimanche ou ne se termine pas le samedi.
Le mois dernier Affiche les données du mois civil précédent sans jours supplémentaires.
30 derniers jours Affiche les données des 30 derniers jours.
3 mois précédents Affiche les données des 3 derniers mois.
Intervalle

Affiche les données pour une période de 30 minutes.

Remarque :  Parce que les vues de détail incluentIntervalle dans la grille de données,Intervalle le préréglage n’est pas affiché pour ces vues.

jour Affiche les données pour une seule journée de 24 heures.
semaine Affiche les données pour une période allant du dimanche au samedi.
Mois Affiche les données du mois exact sans jours supplémentaires. Si le mois en cours est sélectionné, vous verrez les données jusqu’à la date actuelle.
Mois par semaine Affiche les données d’un mois civil commençant le dimanche et se terminant le samedi, y compris les jours supplémentaires si le mois ne commence pas le dimanche ou ne se termine pas le samedi.

Pour filtrer les mesures avec une plage de dates personnalisée, procédez comme suit :

  1. Cliquez sur la date pour afficher le filtre de date.
  2. Sélectionnez une date de début et une date de fin sur le calendrier, puis cliquez sur la flèche de filtrage Le sélecteur de date s’applique.

Pour afficher les données pour une période différente en utilisant les mêmes préréglages de date, cliquez sur les flèches de chaque côté de l’affichage de la date. Filtre de l'année

Par exemple, pour afficher les données de la veille, cliquez sur le jour prédéfini, puis cliquez sur la flèche à gauche de la date.

Les données de la vue peuvent être affichées dans un graphique. Pour afficher le graphique, cliquez sur l'icône Afficher/Masquer le graphique .

Pour filtrer les données par un client spécifique ou une demande d’API, cliquez sur cette demande. 

Vous pouvez filtrer par un client OAuth ou une demande d’API à la fois. Si vous cliquez sur un autre client ou une demande, le filtre change à ce client ou à cette demande. 

Pour plus d’informations sur la façon dont la vue change lorsque vous filtrez, voir le Colonnes de section section dans cet article.