Passer au contenu principal
Administrator Guide
Dernière mise à jour : 2026-04-03
Résolution des problèmes : rapports personnalisés via des API

Résolution des problèmes : rapports personnalisés via des API

L'appel de API a expiré.

Si l'appel API n'est pas traité dans les 60 secondes, l'appel expire et vous recevoir une erreur.
Cause
Solution
Vous avez trop de jointures entre les jeux de données.
Limitez le nombre de jointures utilisées dans les jeux de données.
Vous récupérez un rapport contenant plus de 20 champs.
Limitez le nombre de champs dans un rapport à 10 à 20 maximum. Si le nombre de champs est supérieur à 20, utilisez SFTP pour récupérer le rapport.
Vous avez une forme de données incorrecte. Exemple : vous avez un grand nombre d'organisations imbriquées.
Évitez de récupérer des jeux de données anormalement volumineux.
Vous avez un rapport sans filtre
Utilisez des filtres appropriés pour contenir une croissance de la taille des données. Exemple : récupérez les données modifiées avec un filtre définissant une horizon temporel; période plus petite, telle que
Hier
ou
Aujourd'hui
.
Vous avez effectué une demande dans les minutes qui suivent une demande précédente. Cela est particulièrement vrai pour les rapports qui renvoient des volumes importants de données ou qui comportent plusieurs jointures.
Évitez de faire plusieurs demandes API dans un court délai.
Vous récupérez des rapports contenant plusieurs pages de données.
Les API de reporting sont volontairement conçues pour renvoyer des jeux de données paginés. Il s'agit d'une contrainte standard pour toutes les API basées sur HTTP de VNDLY. Pour éviter ces problèmes :
  • Utilisez la limite (nombre de lignes à renvoyer) et le contrepartie (nombre initial de lignes) pour récupérer une seule page de données.
  • Limitez le nombre de champs inclus dans le rapport.
  • Utilisez SFTP à la place de l' API de reporting pour récupérer des rapports volumineux sans aucune pagination nécessaire.

Vous rencontrez des problèmes de performance pour la récupération des données de vos environnements clients de production, mais pas de vos environnements clients de test.

Les problèmes de performance peuvent ne pas être visibles dans les environnements de test, car la charge de données sera moins importante dans un environnement client de test que dans un environnement client de production.
Solutions :
  • Vérifiez la performance de rapport après la mise en production pour vous assurer que les résultats sont similaires aux environnements clients test.
  • Chargez l' environnement client test avec des données de test avec une taille représentative du chargement de production.
  • Planifier la mise en production. Tenez compte de la taille et de la complexité anticipées d'un rapport contenant des données de production. Les rapports qui s'exécutent près du seuil le dépasseront probablement à la fin du programme ou après sa mise en production.