Minimale API-Nutzungsgrenze erhöht

Wir haben den minimalen API-Grenzwert in allen Editionen erhöht, um Ihr API-Nutzererlebnis zu verbessern.

Weitere Informationen finden Sie unter API-Grenzwerte, um mehr über diese Änderung zu erfahren.

Veröffentlicht am: 1. Nov. 2014

Neue Methode: searchRecords

Wir haben die searchRecords-Methode eingeführt, um Ihnen zu helfen, Datensätze aus Modulen zu suchen. Weitere Informationen zu dieser neuen Methode finden Sie im API-Leitfaden.

Veröffentlicht am: 20. Mai 2014

Neue Methoden: getModules und getDeletedRecordIds

Wir haben die folgenden Methoden eingeführt, um Ihnen zu helfen, die Liste der CRM-Module und IDs der gelöschten Datensätze aus dem Papierkorb abzurufen:

• getModules
• getDeletedRecordIds

Weitere Informationen zu diesen neuen Methoden finden Sie in unserem API-Leitfaden.

Veröffentlicht am: 7. Aug. 2014

Anzahl der API-Anforderungen

Die Zoho CRM-API ist in allen Editionen von Zoho CRM verfügbar. Um die API zu verwenden, benötigen Sie den Zoho CRM-Authentifizierungstoken von Ihrem CRM-Konto. Stellen Sie sicher, dass Sie die Berechtigung für den Zugriff auf den API-Dienst haben. Wenn Sie keine Berechtigung haben, wenden Sie sich an Ihren CRM-Administrator.

API-Grenzwert

Wichtige Hinweise:

• Wenn Sie beispielsweise in der Free Edition die getRecords-Methode verwenden, können Sie maximal 200 Datensätze pro Anfrage abrufen, also insgesamt 50.000 Datensätze pro Tag (250 x 200 = 50.000 Datensätze).
• Wenn Sie die Methoden getSearchRecords oder getCVRecords verwenden, können Sie unabhängig von Ihrer Zoho CRM-Version maximal 250 Anfragen pro Tag senden.

Veröffentlicht am: 15. Juni 2013

Neue Methoden: Anhängen von Dateien oder Fotos an Datensätze mithilfe der Entwickler-API

Wir haben die folgenden Methoden eingeführt, die Ihnen helfen, Dateien oder Fotos an Datensätze anzuhängen:

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

Sie können die vollständige Ankündigung in unseren Entwickler-API-Foren lesen.
Weitere Informationen zu diesen neuen Methoden finden Sie in unserem API-Leitfaden.

Veröffentlicht am: 11. Juli 2012

Authentifizierungstoken eingeführt

Wir unterstützen nun den Authentifizierungstoken in unserer Entwickler-API-Implementierung.

Dieser Token ist ein permanenter Token und wird nur ungültig, wenn Sie ihn löschen.

Erfahren Sie mehr über den Authentifizierungstoken in unserem API-Handbuch.

Veröffentlicht am: 5. März 2012

Neue Methoden eingeführt

Wir haben die folgenden Methoden für unsere Entwickler-API eingeführt:

• getFields
• getRelatedRecords
• updateRelatedRecords

Sie können die vollständige Ankündigung in unseren Entwickler-API-Foren lesen. Weitere Informationen zu diesen neuen Methoden finden Sie in unserem API-Leitfaden.

Veröffentlicht am: 27. Januar 2012

Nur noch HTTPS-Unterstützung ab 28. April 2011:

Derzeit unterstützen wir sowohl HTTP als auch HTTPS bei der Implementierung unserer Entwickler-API. In den nächsten 4 Wochen planen wir, alle API-Transaktionen nur noch über HTTPS zu unterstützen und das HTTP-Protokoll dauerhaft einzustellen. Dieses zusätzliche SSL-, 256-Bit-Sicherheitssystem hilft Ihnen, die Integration von Drittanbieterprodukten bei der Datenübertragung vor Sicherheitsproblemen zu schützen.

Wenn Sie nach dem 28. April 2011 weiterhin HTTP in Ihrem Programm verwenden, werden API-Anfragen nicht ausgeführt, weshalb ich unserer Entwickler-Community dringend empfehlen möchte, die Zoho CRM-API so schnell wie möglich nur noch mit HTTPS-Anfragen aufzurufen.

Neuer Parameter namens "version" eingeführt

Wir haben einen neuen Parameter namens "version" für Entwickler-API-Methoden eingeführt. Mit diesem Parameter können Sie Werte aus dem Feld "Kampagnenquelle" abrufen.
In einer kürzlich erfolgten Erweiterung des Moduls "Campaigns" wurde das Feld "Kampagnenquelle" entfernt, um die Funktion "Kampagnenmitglieder" zu unterstützen. Nach dieser Erweiterung können Sie Folgendes:

• Eine Kampagne mehreren Leads und Kontakte zuordnen
• Zeit sparen, indem Sie mehrere Leads/Kontakte importieren, anstatt sie einzeln zuzuordnen
• Das Feld "Kampagnenquelle" ist in den Modulen "Leads" und "Contacts" nicht verfügbar.

Erfahren Sie mehr über diese Verbesserung in unserem Übergangsleitfaden.

Wie verwenden Sie den Versionsparameter in API-Anfragen?

Mit dem Versionsparameter in Methoden können Sie Werte aus dem Feld "Kampagnenquelle" in Ihrer API-Implementierung abrufen.
Der Parameter "version" mit dem Wert "1" ruft auch Antworten aus dem Feld "Kampagnenquelle" ab.
Der Parameter "version" mit dem Wert "2" ruft Antworten basierend auf der aktuellen API-Implementierung ab. Werte aus dem Feld "Kampagnenquelle" werden in diesem Fall nicht abgerufen.

Dies ist kein obligatorischer Parameter. Bis zum 30. Oktober 2011 werden alle Antworten auf Basis der früheren Implementierung, d. h. vor der Erweiterung, abgerufen. Wenn Sie in diesem Zeitraum Antworten basierend auf der neuen Implementierung abrufen möchten, können Sie den Versionsparameter in Ihren Anfragen mit dem Wert "2" verwenden, d. h. version=2.

Beispiel für die Verwendung des Parameters "version":
Wir haben auch eine neue API-Methode namens getRelatedRecords eingeführt. Sie können Datensätze (Leads, Kontakte usw.) abrufen, die sich auf einen Datensatz in einem anderen Modul beziehen.
So können Sie beispielsweise Leads oder Kontakte zu einer bestimmten Kampagne abrufen. Weitere Informationen

Veröffentlicht am: 17. April 2011

GA-Release der Zoho CRM-Entwickler-API und anderer Änderungen

Wir freuen uns sehr, das GA-Release von API for Zoho CRM Service bekanntzugeben. Unsere API ist in den Formaten XML und JSON verfügbar, was der Entwickler-Community hilft, Anwendungen mit ihrer bevorzugten Programmiersprache zu erstellen. Jetzt sind wir bereit für robuste und viel bessere API-Methoden, um den Anforderungen von Echtzeit-Implementierungen gerecht zu werden. Ihr wertvoller Beitrag zur Fehlererkennung, zur Entwicklung neuer Geschäftsszenarien und zur Veröffentlichung von Beispielen hat uns wirklich geholfen, eine bessere API für unser CRM-System zu entwickeln. Zusätzlich zum GA-Release nehmen wir auch einige wichtige Änderungen an unserer bestehenden API-Implementierung vor, die es uns ermöglichen, die zukünftigen Anforderungen unserer Entwickler-Community zu erfüllen. Einige dieser Änderungen beinhalten das Verwerfen alter Suchmethoden und ein neues Antwortformat, die Einschränkung von API-Anfragen und neue API-Methoden zur Implementierung zusätzlicher CRM-Geschäftslogik. Wir glauben, dass diese Änderungen uns sehr dabei helfen werden, der Entwickler-Community eine bessere Erfahrung zu bieten und die Zoho CRM-Entwicklerplattform auf die nächste Stufe zu heben.

Wichtige Änderungen

• Verwerfen bestehender Suchmethoden – getAllSearchRecords und getMySearchRecords
• Implementierung eines neuen Antwortformats für alle Methoden
• Einschränkung von API-Anfragen basierend auf der Zoho CRM Edition
• Einführung neuer Methoden für Such-, Lead-Konvertierungs- und Löschfunktionen

Verwerfung der API

Um das zukünftige Community-Wachstum, einen besseren Entwicklerservice und die Optimierung der hochleistungsfähigen Abläufe im Blick zu behalten, stellen wir die folgenden API-Methoden aus:

• getAllSearchRecords
• getMySearchRecords

In letzter Zeit stoßen wir bei der Implementierung von getAllSearchRecords und getMySearchRecords auf sehr viel höhere Ressourcenauslastung als erwartet. Um dies zu ändern, führen wir derzeit neue Suchmethoden ein, getSearchRecords und getSearchRecordsByPDC , die einem ähnlichen Zweck dienen. Wir haben diese neuen Methoden für eine bessere Leistung optimiert.

Ende der Lebensdauer: 21. Jan. 2010

Wichtiger Hinweis:

Vor dem Ende der Lebensdauer wird dringend empfohlen, Ihre Anwendung mit den neuen Suchmethoden – getSearchRecordsByPDC oder getSearchRecords zu aktualisieren . Wenn Sie Hilfe oder weitere Informationen benötigen, senden Sie eine E-Mail an: support@zohocrm.com.

Weitere Details zu den veralteten Methoden finden Sie in unserem API-Handbuch.

Neues Antwortformat

Derzeit ist das XML-Format für die API-Antwort < fieldlabel value = "LEADID“ > Feldwert </ fieldlabel>, das ca. 26 Zeichen (inkl. Leerzeichen) in den öffnenden und schließenden Tags enthält. In unserer neuen Implementierung haben wir die Tags verkürzt, indem wir die XML-Tags auf <FL val="LEADID“> Feldwert </FL> geändert haben – insgesamt 8 Zeichen, was etwa 18 Byte pro Feld spart. Dies wird uns sehr helfen, die Auslastung der Bandbreite zu optimieren.
Bis zum 21. Januar 2010 erhalten Sie die Antwort standardmäßig im alten Format. Wenn Sie die Antwort im neuen Format erhalten möchten, müssen Sie das zusätzliche Argument mit newFormat=1 oder 2 in der API-Anfrage übergeben, um Daten von Zoho CRM abzurufen.

Wichtiger Hinweis:

Beachten Sie, dass Sie zum Einfügen oder Aktualisieren von Datensätzen den Parameter newFormat=1 für XML-Daten verwenden müssen.

Altes Format:

In diesem Beispiel werden alle Felder trotz der “Null"-Werte im Datensatz abgerufen. Wenn Sie 150 Felder in einem Modul haben, müssen wir Daten für alle Felder abrufen, was eine unnötige Bandbreitenauslastung erfordert. Neues Format:

In diesem Beispiel rufen wir die Felder ohne Werte nicht durch Übergabe des Parameters newFormat=1 ab. Wichtige Punkte:

• Das XML-Tag wurde von <fieldlable value=""> Feldwert </fieldlable> zu <FL val=""> Feldwert <FL geändert.>
• Sie können das Abrufen von Datensätzen mit ohne Werte stoppen, indem Sie newFormat=1 in der API-Anfrage übergeben. Wenn Sie Daten für alle Felder (einschließlich Felder ohne Werte) abrufen möchten, verwenden Sie den Parameter newFormat=2.

Neues Antwortformat – verfügbar ab 22. Oktober 2009

EOL des alten Antwortformats – 21. Jan. 2010

Anzahl der API-Anforderungen

Für eine bessere Leistung und einen besseren Entwicklerservice werden wir die Anzahl der API-Anfragen wie unten beschrieben begrenzen:

Wenn Sie beispielsweise in der Free Edition die getSearchRecords-Methode verwenden, können Sie maximal 200 Datensätze pro Anfrage abrufen, also insgesamt 50.000 Datensätze pro Tag (250 x 200 = 50.000 Datensätze).

Wichtiger Hinweis:

Die oben genannten Einschränkungen gelten für alle bestehenden und neuen Benutzer. In Zukunft planen wir, den CRM-Administrator (Super-Administrator des Zoho CRM-Kontos) zu benachrichtigen, wenn Ihr Unternehmen die oben genannte Grenze überschreitet. Darüber hinaus stellen wir Ihnen auch API-Statistiken zur Verfügung, um Ihre Integrationsanforderungen besser einschätzen zu können.

Implementierungsdatum: 21. Jan. 2010

Ab dem 21. Jan. 2010 (12:00 Uhr PST) können Sie API-Aufrufe gemäß Ihrer Zoho CRM Edition anfordern. Falls Ihre Anwendung mehr als die Obergrenze erfordert, werden Ihre zusätzlichen API-Anfragen nicht bearbeitet. Um Probleme bei der Datenübertragung zu vermeiden, bewerten Sie bitte Ihre API-Anforderungen frühzeitig. Wenn Sie Hilfe benötigen, wenden Sie sich an unseren Support unter Support@zohocrm.com, oder rufen Sie uns an: +1 888 900 9646

Neue API-Methoden

Wir freuen uns sehr, die folgenden neuen Methoden zum Nutzen der wachsenden Entwickler-Community einzuführen:

• getSearchRecords
• getSearchRecordsByPDC
• deleteRecords
• convertLead

Wir sind zuversichtlich, dass die oben genannten Methoden bei der Implementierung von Suchfunktionen sehr nützlich sein werden und es Ihnen ermöglichen, zusätzliche Geschäftslogik über unsere API zu entwickeln. Diese Methoden werden für alle Editionen sofort zur Verfügung gestellt.

Verfügbar ab: 22.Oktober 2009

Weitere Informationen zu neuen API-Methoden finden Sie in unserem API-Handbuch.

Sonstige Änderungen

Darüber hinaus nehmen wir die folgenden geringfügigen Änderungen vor:

• Maximal 200 Datensätze pro API-Anfrage abrufen
• Das neue Antwortformat ist auf alle API-Methoden anwendbar (sowohl bestehende als auch neue Methoden).
• Datensätze mit den angegebenen Feldern über den Parameter selectColumns abrufen
• Wir haben auch das API-Handbuch aktualisiert und offizielle Entwicklerforen eingerichtet.