Problème :
Je compare les données de complétion de l’API aux rapports intégrés à l’application et je constate des différences dans les données. Certaines complétions semblent manquer lors du filtrage par fournisseur de contenu, type de contenu ou statut de vérification. De plus, les nombres de complétions et les dates ne correspondent pas entre l’API et les rapports intégrés à l’application.
Cause :
Cette différence s’explique par le fait que l’API et les rapports dans l’application gèrent les dates de complétion différemment :
- Le champ API completed_at ne se remplit que lorsqu’une complétion a été validée via une intégration, une API ou un chargement de fichier.
- Si un utilisateur marque manuellement un élément comme terminé, l’API renvoie la valeur nulle pour completed_at
- Le rapport dans l’application affiche à la place la date added_at comme « Date de complétion » lorsqu’il n’y a pas de complétion validée.
Il est donc possible qu’une même complétion s’affiche avec une date dans le rapport intégré à l’application, mais qu’elle est nulle ou manquante dans l’API, ce qui entraîne des incohérences dans les registres ou les décomptes.
Résolution :
Pour concilier les différences entre les rapports API et les rapports dans l’application :
- Comparer les champs completed_at et added_at lors de l’analyse des données d’API.
- Attendez completed_at = invalide pour les éléments terminés manuellement marqués comme terminés et non validés via l’intégration ou le chargement de fichier dans les données d’API.
- Évitez de vous baser uniquement sur completed_at pour valider des totaux ou filtrer les résultats.