Die Version 1.0 der Zoho CRM-APIs befindet sich im End-of-Life Zeitraum und wird am 31. Dezember 2018 veraltet sein. Wir empfehlen Ihnen, die neue und bessere API 2.0 zu testen.
Verwendung von Authentifizierungstoken
Inhaltsverzeichnis
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.
Authentifizierungstoken generieren
Um den Authentifizierungstoken zu generieren, müssen Sie eine Authentifizierungsanfrage an Zoho-Konten im folgenden URL-Format senden. Stellen Sie sicher, dass Sie ein bestätigter Benutzer sind, sonst erhalten Sie beim Erzeugen des Authentifizierungstoken möglicherweise einen Fehler – "ACCOUNT_REGISTRATION_NOT_CONFIRMED".
URL-Format
API-Modus:
Um Authentifizierungstoken im API-Modus zu generieren, gehen Sie wie folgt vor:
- Melden Sie sich bei Zoho CRM an.
- Öffnen Sie https://accounts.zoho.com .
- Klicken Sie auf der Startseite von Zoho Accounts Home auf Zwei-Faktor-Authentifizierung.
- Klicken Sie auf der Seite Zwei-Faktor-Authentifizierung auf die Schaltfläche Verwalten von anwendungsspezifischen Passwörtern.
- Gehen Sie im Pop-up-Fenster Anwendungsspezifische Passwörter wie folgt vor:
- Geben Sie den Geräte- oder App-Namen ein.
- Geben Sie das aktuelle Passwort ein.
- Klicken Sie auf Generieren. Sie erhalten das neue anwendungsspezifische Passwort mit Leerzeichen.
- Entfernen Sie die Leerzeichen im Passwort, und fügen Sie die folgende API-Modus-URL hinzu, um den Authentifizierungstoken zu generieren.
Hinweis:
- Verwenden Sie die HTTP POST-Methode, um die Anfrage zu stellen.
Parameter, die mit dieser URL übergeben werden sollen, sind:
| Parameter | Beschreibung |
| EMAIL_ID | Geben Sie Ihren Zoho CRM Benutzernamen oder Ihre E-Mail-ID ein |
| Bereich | Geben Sie den Wert als ZohoCRM/crmapi an. |
| PASSWORT | Geben Sie Ihr Zoho CRM Passwort an. |
| DISPLAY_NAME | Geben Sie den Anwendungsnamen an, der den Zweck der Verwendung dieses AuthToken beschreibt. Zum Beispiel "MailChimp" oder "Google Apps" |
Weitere Informationen finden Sie auf der Hilfeseite Zwei-Faktor-Authentifizierung .
Beispielantwort
Hinweis:
- Der Authentifizierungstoken kann in allen Ihren API-Aufrufen verwendet werden. Das URL-Format finden Sie ebenfalls unter Setup > Developer Space > APIs.
- Sie müssen in Ihrem CRM-Konto angemeldet sein, um den Browser-Modus nutzen zu können.
Beispiel
Beispiel für das Abrufen von Datensätzen:
Authentifizierungstoken widerrufen
Sie können den für Ihr Konto generierten Authentifizierungstoken auf der Seite "Mein Zoho Konto" löschen.
- Melden Sie sich bei Zoho CRM an.
- Öffnen Sie [Benutzername] > Mein Konto.
- Klicken Sie auf der Seite Konten auf Aktive Authentifizierungstoken.
- Auf der Seite Aktive Authentifizierungstoken können Sie Authentifizierungstoken entfernen (widerrufen).
Hinweis:
- Aus Sicherheitsgründen können Sie die vorhandenen Authentifizierungstoken nicht anzeigen. Speichern Sie den Authentifizierungstoken, wenn er generiert ist.
- Das Entfernen eines Authentifizierungstoken löscht den Token dauerhaft.
- Wenn Sie Authentifizierungstoken neu generieren, aktualisieren Sie Ihr Programm mit dem neuen Token.
Zu beachtende Punkte
- Der Authentifizierungstoken ist benutzerspezifisch und ist ein permanenter Token.
- Beim Löschen wird der bestehende Token dauerhaft gelöscht. Der neue Token muss in allen API-Aufrufen ersetzt werden.
- Der Authentifizierungstoken des Benutzerkontos wird ungültig, wenn der Benutzer deaktiviert wird.
- Wir benachrichtigen CRM-Benutzer (Benutzer, die den Authentifizierungstoken generiert haben), wenn Ihr Unternehmen den API-Grenzwert überschreitet.
- Falls Ihre Anwendung mehr als die Obergrenze benötigt, 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 bitte an unseren Support unter Support@zohocrm.com