Augmentation de la limite minimale d'utilisation de l'API

Nous avons augmenté la limite minimale de l'API dans toutes les éditions pour améliorer votre expérience d'utilisation de l'API.

Pour plus de détails, voir Limites de l'API afin d'en savoir plus sur ce changement.

Publié le : 1er novembre 2014

Nouvelle méthode : searchRecords

Nous avons introduit la méthode searchRecords pour vous aider à chercher des enregistrements à partir de modules. Consultez le Guide de l'API pour en savoir plus sur cette nouvelle méthode.

Publié le : 20 octobre 2014

Nouvelles méthodes : getModules et getDeletedRecordIds

Nous avons introduit les méthodes suivantes pour vous aider à récupérer la liste des modules CRM et les ID d'enregistrements supprimés dans la corbeille :

• getModules
• getDeletedRecordIds

Consultez notre Guide de l'API pour en savoir plus sur ces nouvelles méthodes.

Publié le : 7 août 2014

Nombre de requêtes API

L'API Zoho CRM est disponible dans toutes les éditions de Zoho CRM. Pour utiliser l'API, vous aurez besoin du jeton d'authentification Zoho CRM de votre compte CRM. Assurez-vous d'avoir l'autorisation d'accéder au service de l'API. Si vous n'avez pas l'autorisation, veuillez contacter votre administrateur CRM.

Limite de l'API

Remarques importantes :

• Par exemple, dans l'édition gratuite, si vous utilisez la méthode getRecords, vous pouvez récupérer un maximum de 200 enregistrements par demande, soit un total de 50 000 enregistrements par jour (250 x 200 = 50 000 enregistrements).
• Si vous utilisez les méthodes getSearchRecords ou getCVRecords, vous pouvez envoyer un maximum de 250 appels par jour, quelle que soit votre édition Zoho CRM.

Publié le : 15 juin 2013

Nouvelles méthodes : joindre des fichiers ou des photos à des enregistrements à l'aide de l'API pour développeur

Nous avons introduit les méthodes suivantes, qui vous permettent de joindre des fichiers ou des photos à des enregistrements :

• uploadFile
• downloadFile
• deleteFile
• uploadPhoto
• downloadPhoto
• deletePhoto

Vous pouvez lire l'annonce complète dans nos Forums API pour développeur.
Consultez notre Guide de l'API pour en savoir plus sur ces nouvelles méthodes.

Publié le : 11 juillet 2012

Jeton d'authentification introduit

Nous prenons désormais en charge le jeton d'authentification dans notre mise en œuvre d'API pour développeur.

Ce jeton est un jeton permanent et ne deviendra non valide que si vous choisissez de le supprimer.

En savoir plus sur le jeton d'authentification dans notre Guide de l'API.

Publié le : 5 mars 2012

Nouvelles méthodes introduites

Nous avons introduit les méthodes suivantes dans notre API pour développeur :

• getFields
• getRelatedRecords
• updateRelatedRecords

Vous pouvez lire l'annonce complète dans nos Forums API pour développeur. Consultez notre Guide de l'API pour en savoir plus sur ces nouvelles méthodes.

Publié le : 27 janvier 2012

Prise en charge de HTTPS seul à partir du 28 avril 2011 :

À l'heure actuelle, nous prenons en charge les protocoles HTTP et HTTPS lors de la mise en œuvre de notre API pour développeur. Dans un délai de 4 semaines, nous avons l'intention de prendre en charge toutes les transactions API uniquement via HTTPS et d'interrompre définitivement le protocole HTTP. Ce système de sécurité SSL 256 bits supplémentaire vous aidera à protéger les intégrations tierces contre les problèmes de sécurité lors du transfert des données.

Après le 28 avril 2011, si vous continuez à utiliser le protocole HTTP dans votre programme, les requêtes API ne seront pas exécutées. Par conséquent, je recommande fortement à notre communauté de développeurs d'appeler l'API Zoho CRM uniquement avec des requêtes HTTPS dès que possible.

Nouveau paramètre appelé « version » introduit

Nous avons introduit un nouveau paramètre appelé version pour les méthodes API pour développeur. Vous pouvez récupérer des valeurs depuis le champ Campaign Source (Source de la campagne) avec ce paramètre.
Dans une récente amélioration du module Campaigns (Campagnes), le champ Campaign Source (Source de la campagne) a été retiré pour prendre en charge la fonction des membres de la campagne. Suite à cette amélioration :

• Vous pouvez désormais associer plusieurs prospects et contacts à une campagne.
• Vous pouvez gagner du temps en important plusieurs prospects/contacts au lieu de les associer un par un.
• Le champ Campaign Source (Source de la campagne) ne sera pas disponible dans le module Contacts et Leads (Prospects).

En savoir plus sur cette amélioration dans notre Guide de transition.

Comment utiliser le paramètre version dans les requêtes API ?

Vous pouvez utiliser le paramètre version dans les méthodes pour récupérer des valeurs depuis le champ Campaign Source (Source de la campagne) dans votre mise en œuvre d'API.
Le paramètre « version » avec une valeur « 1 » ira également récupérer les réponses depuis le champ Campaign Source (Source de la campagne).
Le paramètre « version » avec une valeur « 2 » ira récupérer les réponses en fonction de la mise en œuvre actuelle de l'API. Les valeurs du champ Campaign Source (Source de la campagne) ne seront pas récupérées dans ce cas.

Ce n'est pas un paramètre obligatoire. Jusqu'au 30 octobre 2011, toutes les réponses seront récupérées en fonction de la mise en œuvre précédente, c'est-à-dire avant l'amélioration. Pendant cette période, si vous souhaitez récupérer des réponses en fonction de la nouvelle mise en œuvre, vous pouvez utiliser le paramètre version dans vos requêtes avec une valeur « 2 », c'est-à-dire version=2.

Voici un exemple d'utilisation du paramètre « version ».
Nous avons aussi introduit une nouvelle méthode API appelée getRelatedRecords. Vous pouvez récupérer des enregistrements (prospects, contacts, etc.) liés à un enregistrement dans un autre module.
Par exemple, vous pouvez récupérer des prospects ou des contacts liés à une campagne particulière.En savoir plus

Publié le : 17 avril 2011

Publication GA de l'API pour développeur Zoho CRM et autres changements

Nous sommes très heureux de vous annoncer la publication GA de l'API pour le service Zoho CRM. Notre API est disponible aux formats JSON et XML, ce qui aide la communauté des développeurs à créer des applications en utilisant leur langage de programmation favori. Avec des méthodes API plus solides et plus efficaces, nous sommes maintenant prêts à répondre aux besoins des déploiements en temps réel. Votre précieuse contribution pour l'identification des bugs, l'élaboration de nouveaux scénarios métier et la publication d'exemples nous a permis d'aboutir à une meilleure API pour notre système CRM. En plus de la publication GA, nous avons également apporté des changements importants à la mise en œuvre existante de notre API, qui nous permettent de satisfaire les futurs besoins de notre communauté de développeurs. Certains de ces changements comprennent le retrait des méthodes de recherche, un nouveau format de réponse, la restriction des requêtes API et de nouvelles méthodes API pour la mise en œuvre de logiques métier CRM supplémentaires. Nous pensons que ces changements vont nous aider à offrir une meilleure expérience à la communauté des développeurs et à optimiser la plateforme de développement Zoho CRM.

Changements importants

• Retrait des méthodes de recherche existantes - getAllSearchRecords et getMySearchRecords
• Mise en œuvre d'un nouveau format de réponse pour toutes les méthodes
• Restriction des requêtes API en fonction de l'édition de Zoho CRM
• Introduction de nouvelles méthodes pour les fonctions Search (Recherche), Lead Conversion (Conversion de prospects) et Delete (Supprimer)

Retrait de l'API

Pour garantir la croissance future de la communauté, proposer de meilleurs services aux développeurs et optimiser les opérations les plus exigeantes, nous sommes en train d'éliminer progressivement les méthodes API suivantes :

• getAllSearchRecords
• getMySearchRecords

Dernièrement, nous avons été confrontés à l'utilisation d'une quantité de ressources bien plus importante que prévu pendant la mise en œuvre de getAllSearchRecords et getMySearchRecords. Pour surmonter ce genre de situation, nous introduisons de nouvelles méthodes de recherche, getSearchRecords et getSearchRecordsByPDC, qui ont le même but. Nous avons optimisé ces nouvelles méthodes pour améliorer les performances.

Fin de vie : 21 janvier 2010

Remarque importante :

Avant la fin de vie, il est vivement recommandé de mettre à jour votre application avec les nouvelles méthodes de recherche : getSearchRecords ou getSearchRecordsByPDC. Pour obtenir de l'aide ou des éclaircissements, veuillez nous contacter par e-mail à l'adresse support@zohocrm.com.

Pour plus de détails sur les méthodes retirées, veuillez consulter notre Guide de l'API.

Nouveau format de réponse

À l'heure actuelle, le format XML pour la réponse de l'API est < fieldlabel value = "LEADID" > Field Value </ fieldlabel>, qui contient environ 26 caractères (espaces compris) dans les balises d'ouverture et de fermeture. Dans notre nouvelle mise en œuvre, nous avons réduit la taille de la balise en changeant les balises XML en <FL val="LEADID"> Field Value </FL>, soit un total de 8 caractères, ce qui permet d'économiser environ 18 octets par champ. Cela va nous aider à optimiser l'utilisation de la bande passante.
Jusqu'au 21 janvier 2010, par défaut, vous obtiendrez la réponse dans l'ancien format. Si vous souhaitez obtenir la réponse dans le nouveau format, vous devez transmettre l'argument supplémentaire avec newFormat=1 ou 2 dans la requête API pour récupérer les données à partir de Zoho CRM.

Remarque importante :

Veuillez noter que vous devez utiliser les données XML du paramètre newFormat=1 pour insérer ou mettre à jour des enregistrements.

Ancien format :

Dans cet exemple, tous les champs sont récupérés en dépit des valeurs « null » de l'enregistrement. Si vous avez 150 champs dans un module, nous devons récupérer les données pour tous les champs, ce qui exige une utilisation inutile de bande passante. Nouveau format :

Dans cet exemple, nous ne récupérons pas les champs contenant des valeurs « null » en transmettant le paramètre newFormat=1.Points clés :

• La balise XML a été modifiée de <fieldlabel value=""> field value </fieldlabel> en <FL val=""> field value <FL.>
• Vous pouvez arrêter la récupération des enregistrements avec des valeurs « null » en transmettant newFormat=1 dans la requête API. Si vous souhaitez récupérer les données pour tous les champs (y compris les valeurs null), utilisez le paramètre newFormat=2.

Nouveau format de réponse - Disponible à partir du 22 octobre 2009

Fin de vie de l'ancien format de réponse - 21 janvier 2010

Nombre de requêtes API

Pour de meilleures performances et un meilleur service pour les développeurs, nous allons limiter le nombre de requêtes API comme indiqué ci-dessous :

Par exemple, dans l'édition gratuite, si vous utilisez la méthode getSearchRecords, vous pouvez récupérer un maximum de 200 enregistrements par demande, soit un total de 50 000 enregistrements par jour (250 x 200 = 50 000 enregistrements).

Remarque importante :

Les restrictions ci-dessus sont applicables à tous nos utilisateurs existants et nouveaux utilisateurs. À l'avenir, nous prévoyons d'informer l'administrateur CRM (Super Administrateur du compte Zoho CRM) si votre organisation dépasse la limite mentionnée ci-dessus. Nous fournirons également des statistiques de l'API pour une meilleure évaluation de vos besoins d'intégration.

Date de mise en œuvre : 21 janvier 2010

À partir du 21 janvier 2010 (00h00 PST), vous pouvez demander des appels d'API selon votre édition Zoho CRM. Si votre application nécessite plus que la limite supérieure, vos requêtes API supplémentaires ne seront pas traitées. Pour éviter les problèmes de transfert de données, veuillez évaluer vos exigences API bien à l'avance. Si vous avez besoin d'aide, contactez notre support à l'adresse support@zohocrm.com ou appelez-nous au +1 888 900 9646.

Nouvelles méthodes API

Nous sommes ravis d'introduire les nouvelles méthodes suivantes au profit de la communauté de développeurs en plein essor :

• getSearchRecords
• getSearchRecordsByPDC
• deleteRecords
• convertLead

Nous sommes convaincus que les méthodes ci-dessus seront très utiles dans la mise en œuvre des fonctions de recherche et vous permettront de développer une logique métier supplémentaire grâce à notre API. Ces méthodes seront disponibles pour toutes les éditions immédiatement.

Disponible à partir du : 22 octobre 2009

Pour plus d'informations sur les nouvelles méthodes API, veuillez consulter notre Guide de l'API

Autres changements

En outre, nous intégrons les modifications mineures suivantes :

• Récupération d'un maximum de 200 enregistrements par requête API.
• Le nouveau format de réponse s'applique à toutes les méthodes API (les méthodes existantes et les nouvelles méthodes).
• Récupération des enregistrements avec les champs spécifiés à l'aide du paramètre selectColumns.
• Nous avons également mis à jour le Guide de l'API et lancé des Forums pour développeur officiels.