A computer showing a few icons related to reports API, a magnifier, graphs, video, call and more, a padlock, a robot.

L'API de Reports de Vonage est maintenant disponible en général

Publié le October 9, 2025

Temps de lecture : 5 minutes

Introduction

Nous sommes ravis de présenter l Reports API de VonageVonage Reports API, une API qui vous permet de voir et d'utiliser vos données de communication sur une plateforme centralisée. Au lieu d'extraire des données de plusieurs sources et de les assembler, vous disposez maintenant d'une API unique qui fournit une vue cohérente de vos communications, ce qui les rend plus rapides, plus simples et plus faciles à utiliser.

Caractéristiques principales

Avec l'API Reports, vous pouvez suivre l'état des livraisons, accéder aux informations de facturation, détecter les fraudes potentielles et même alimenter vos propres tableaux de bord avec des données en direct. En bref, il s'agit d'un centre unique de suivi et de gestion des communications.

Aucune installation n'est nécessaire

L'API est prête à être utilisée par tous les clients de Vonage. Vous n'avez besoin que de votre clé API et de votre secret pour commencer à faire des requêtes.

Aperçu complet des données

L'API Reports offre une interface unique pour la visualisation et la gestion de toutes vos données de communication. Elle consolide les données d'utilisation à travers une large gamme de produits Vonage, y compris :

  • SMS API, y compris le contrôle du trafic

  • Voice API (In-App Voice, appels WebSocket, Text-to-Speech, ASR, AMD, SIP, PSTN)

  • API Messages (WhatsApp, RCS, SMS/MMS, Viber, Facebook Messenger, Instagram)

  • Verify

  • API de réseau (Identity Insights, y compris Number Insight)

  • Video API

Options de tarification flexibles

Nous avons prévu deux modes de paiement pour que vous puissiez choisir celui qui vous convient le mieux :

  • Payez au fur et à mesure: Idéal pour les petits ensembles de données ou les requêtes occasionnelles. Vous payez par enregistrement récupéré.

  • Plan illimité: Un tarif mensuel fixe pour les utilisateurs de gros volumes. Recommandé si vous tirez plus d'un million d'enregistrements par mois ou 12 millions par an.

Deux façons de récupérer les données

  • Les requêtes synchrones sont idéales pour les petits rapports rapides (jusqu'à environ 10 000 enregistrements).

  • Les requêtes asynchrones sont conçues pour les rapports volumineux, jusqu'à 7 millions d'enregistrements à la fois.

Filtrage avancé

Filtrez par plage de dates, identifiant d'événement, numéros de téléphone ou sous-comptes pour retrouver exactement ce dont vous avez besoin.

Gestion des comptes auxiliaires

Si votre entreprise possède plusieurs sous-comptes, vous pouvez interroger chacun d'entre eux séparément. Cela permet d'accélérer les requêtes plus importantes et d'organiser vos données.

Disponibilité en temps réel

Les données sont généralement disponibles en temps réel, bien qu'il y ait quelques différences en fonction du produit :

  • Voice API : Les données sont prêtes dès que l'appel est terminé.

  • Verify API : Les données sont prêtes une fois le flux de travail terminé. Les données sur les canaux sont disponibles instantanément

  • Video API : Disponible dans un délai de 30 à 120 minutes après le traitement.

  • La plupart des autres API : Les mises à jour sont instantanées.

Cas d'utilisation dans le monde réel

L'API Reports peut vous aider à résoudre de nombreux problèmes courants :

  • Rapports d'utilisation et de facturation : accédez aux enregistrements détaillés des appels et aux journaux des messages pour trouver des factures et contrôler les coûts.

  • Suivi de l'état de livraison : vérifiez instantanément l'état d'un message ou d'un appel sans avoir à consulter l'ensemble des données.

  • Contrôle financier : générer des factures pour les sous-comptes, idéal pour les revendeurs gérant plusieurs clients.

  • Gestion des campagnes : suivez les performances en temps quasi réel et ajustez les campagnes en conséquence.

  • Détection de la fraude : identifier les les schémas de fraude et prendre des mesures à l'aide de l'outil Fraud Defender pour prendre des mesures.

  • Tableaux de bord en temps réel : données d'utilisation en direct dans des outils de BI ou des tableaux de bord personnalisés pour une vision instantanée.

Meilleures pratiques

Voici quelques conseils pour tirer le meilleur parti de l'API Reports :

  • Optimisation des demandes grâce à des filtres : utilisez des filtres (tels que des plages de dates, des identifiants ou des numéros de téléphone) pour ne récupérer que les données nécessaires, ce qui permet de réduire les coûts et d'améliorer l'efficacité.

  • Bonnes pratiques pour le suivi de l'état des messages : Demandez des rapports à l'aide de l'option id avec la méthode synchrone pour suivre efficacement le dernier statut du message sans appels répétés.

  • Optimisation des requêtes avec tous vos sous-comptes : Pour les comptes principaux comportant plus de 10 sous-comptes, récupérez d'abord la liste des sous-comptes via l'API Sous-comptes, puis appelez l'API Reports séparément pour chaque sous-compte et pour le compte principal lui-même.

  • Comprendre la tarification et le paiement au fur et à mesure : Étant donné que les frais s'appliquent par enregistrement et par rapport, utilisez le tableau de bord analytique pour estimer le volume de CDR et éviter les demandes en double inutiles.

  • Gestion des limites : Respectez la limite de taille des rapports asynchrones (1 Go) et les limites de débit (5 requêtes asynchrones ou 10 requêtes synchrones par seconde) en regroupant les requêtes à l'aide de filtres.

  • Choisir entre la méthode synchrone et la méthode asynchrone : Utilisez la méthode synchrone pour les petits besoins de données en temps réel et la méthode asynchrone pour les ensembles de données plus importants ou les exportations CSV entre plusieurs sous-comptes.

  • Contrôler efficacement l'utilisation de l'API : Suivez l'utilisation en interne ou utilisez le produit gratuit REPORTS-USAGE pour analyser les 13 derniers mois d'activité de l'API Reports et optimiser les performances.

Vous pouvez obtenir des détails complets sur chacun d'entre eux dans notre documentation.

Conclusion

L'API Reports de Vonage est disponible dès maintenant, et il est prêt à vous aider à suivre, analyser et gérer toutes vos analyses de communications. Que votre objectif soit d'optimiser les campagnes, de contrôler les coûts, d'automatiser la facturation et le suivi de l'utilisation, ou de détecter les fraudes, cette API pour les rapports vous offre une visibilité et un contrôle complets. Pour commencer à utiliser l'API Reports, consultez la documentation Reports API et commencez à construire.

Vous avez une question ou souhaitez partager ce que vous construisez ?

Restez connecté et tenez-vous au courant des dernières nouvelles, astuces et événements concernant les développeurs.

Partager:

https://a.storyblok.com/f/270183/384x384/b68093ec17/diana-pham.png
Diana PhamDéfenseur des développeurs

Diana est défenseur des développeurs chez Vonage. Elle aime manger des huîtres fraîches.