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

Résolution des problèmes : rapports personnalisés au moyen d’API

Le délai d'appel de API est dépassé.

Si l'appel API n'est pas traité en moins de 60 secondes, le délai d'attente de l'appel et vous réceptionner le erreur: .
Cause
Solution
Vous avez trop de jointures dans tous les jeux de données.
Limitez le nombre de jointures utilisées dans tous les jeux de données.
Vous récupérez un rapport qui contient plus de 20 champs.
Limiter le nombre de champs dans un rapport à un maximum de 10 à 20 champs. Si le nombre de champs est supérieur à 20, utilisez SFTP pour récupérer le rapport.
Votre forme de données est irrégulière. Exemple : vous avez un grand nombre d’organisations imbriquées.
Évitez de récupérer des jeux de données anormaux.
Vous avez un rapport sans filtre
Utiliser des filtres appropriés pour contenir la croissance de la taille des données. Exemple : récupérez des données modifiées avec un filtre définissant une plage de temps plus courte, comme
Hier
ou
Aujourd’hui
, .
Vous avez fait une demande dans les minutes d'une demande précédente de . Cela s’applique particulièrement bien aux rapports qui renvoient de gros volumes de données ou ont plusieurs jointures.
Évitez de faire plusieurs demande API dans un court délai.
Vous récupérez des rapports contenant plusieurs pages de données.
Les interfaces de programmation d’applications de rapports sont conçues à dessein pour renvoyer des jeux de données pages. Il s'agit d'une contrainte standard pour toutes les API basées sur le HTTPS de VNDLY. Pour éviter ce problème :
  • Utilisez la limite (nombre de rangées à retourner) et le contrepartie (nombre de rangées de départ) pour extraire une seule page de données.
  • Limitez le nombre de champs inclus dans le rapport.
  • Utilisez SFTP plutôt que l’ API de production de rapports pour récupérer des rapports volumineux sans avoir à effectuer de pagination.

Vous rencontrez des problèmes de performance pour récupérer les données de vos locataires de production, mais pas vos locataires de test.

Il est possible que les problèmes de performance ne surviennent pas dans les locataires de test, car le chargement de données est moins dans un locataire de test que dans un locataire de production.
Solutions :
  • Vérifiez le performance des rapports après la mise en production afin de vérifier que les résultats sont similaires à ceux des locataires de test.
  • Chargez le locataire de test avec des données de test dont la taille est représentative de la charge de production.
  • Planifiez l’évolutivité en production. Tenir compte de la taille et de la complexité prévues du chargement d’un rapport avec des données de production. Les rapports qui s'exécutent près du seuil sont susceptibles de les dépasser à l' Paramètres du programme ou après la mise en production.