Comment récupérer les journaux d'audit dans Zoho

La récupération des journaux d'audit dans Zoho CRM est simple grâce à un unique endpoint GET qui renvoie un historique paginé de l'activité du compte. Voici ce que vous devez savoir pour l'appeler correctement.

Pourquoi c'est important

Les journaux d'audit offrent aux administrateurs une visibilité sur qui a modifié quoi et quand au sein d'une organisation Zoho CRM. Vous en aurez besoin lors de l'investigation de modifications de données inattendues, de la préparation d'un audit de conformité, ou simplement pour conserver un historique de l'activité des utilisateurs au fil du temps. Sans accès programmatique à ces journaux, retrouver l'origine d'un problème de données peut s'avérer long et source d'erreurs.

Étape par étape

Étape 1. Assurez-vous de disposer d'un jeton d'accès OAuth 2.0 valide pour votre organisation Zoho CRM. Le jeton est obtenu en complétant le flux OAuth standard de Zoho, qui renvoie un accesstoken accompagné d'une valeur expiresin (généralement 3 600 secondes). Stockez l'horodatage d'expiration afin de pouvoir actualiser le jeton avant d'effectuer la requête vers le journal d'audit. ^[3]

Étape 2. Effectuez une requête GET vers l'endpoint /settings/auditlog. Il s'agit de l'opération dédiée — désignée en interne sous le nom getaudit_log — qui se trouve dans la catégorie Backup & History de l'API des paramètres Zoho CRM. ^[1]

GET /settings/audit_log

Étape 3. Transmettez les paramètres de requête nécessaires via le dictionnaire p (ou la chaîne de requête équivalente dans votre client HTTP). L'endpoint accepte un objet paramètre p, vous pouvez donc inclure des options de pagination ou de filtrage sous forme de paires clé-valeur dans cette structure. ^[1]

Un appel Python minimal ressemble à ceci :

# Assuming `client` is your authenticated Zoho CRM API client
response = client.request("GET", "/settings/audit_log", {})

Pour paginer ou filtrer, renseignez le dictionnaire de paramètres avant de le transmettre :

params = {"page": 1, "per_page": 50}
response = client.request("GET", "/settings/audit_log", params)

Étape 4. Analysez la réponse JSON. La charge utile renvoyée contiendra les entrées d'audit de votre organisation. Parcourez les résultats et stockez-les ou affichez-les selon les besoins de votre flux de travail de reporting ou de conformité. ^[1]

Étape 5. Si vous créez une interface utilisateur par-dessus cette API, envisagez de construire des liens profonds directs vers l'interface Zoho CRM afin que les administrateurs puissent accéder directement à l'enregistrement concerné. Le modèle d'URL CRM suit le format https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, où dc est le suffixe de votre centre de données (par exemple, com, eu, in). ^[4]

Erreurs courantes

• Jeton d'accès expiré. Le jeton OAuth expire après la fenêtre expiresin. Si vous recevez une erreur d'authentification, vérifiez si tokenexpires_at est dépassé et actualisez le jeton avant de réessayer. ^[3]
• Mauvais centre de données. Zoho opère sur plusieurs centres de données régionaux. Si votre organisation se trouve sur le centre de données EU ou IN, l'URL de base doit le refléter (par exemple, zoho.eu plutôt que zoho.com). L'envoi de requêtes vers le mauvais centre de données entraînera des erreurs d'authentification ou des erreurs 404. ^{[3] [4]}
• Paramètre p vide. La fonction getauditlog utilise par défaut un dictionnaire vide {} lorsqu'aucun paramètre n'est fourni. Cela est valide et renverra la page de résultats par défaut, mais si vous attendez des données filtrées et oubliez de transmettre vos filtres, vous recevrez silencieusement des résultats non filtrés. ^[1]
• Permissions insuffisantes. L'accès aux journaux d'audit est généralement limité aux profils de niveau administrateur dans Zoho CRM. Assurez-vous que les scopes OAuth et le profil utilisateur CRM associé à votre jeton disposent des permissions de paramètres nécessaires avant d'appeler cet endpoint. ^[1]

Ce qu'il faut vérifier

• Validité du jeton : Confirmez que votre access_token n'a pas expiré et qu'il a été émis avec le scope de paramètres CRM correct avant d'effectuer la requête.
• Alignement du centre de données : Vérifiez que l'URL de base dans votre client API correspond au centre de données où votre organisation Zoho CRM est hébergée. ^{[3] [4]}
• Pagination de la réponse : Vérifiez si la réponse inclut des métadonnées de pagination et que vous parcourez bien toutes les pages si vous avez besoin d'un historique d'audit complet plutôt que de la première page uniquement. ^[1]

---

*Beam Help est une ressource d'assistance experte indépendante pour les utilisateurs de Zoho — nous ne sommes pas le support officiel de Zoho. Pour les problèmes liés à la plateforme ou les questions de facturation, veuillez contacter Zoho directement.*