Erste Schritte
Für die folgenden Schritte sind Administratorrechte für Ihre Marketo-Instanz erforderlich.
Für Ihren ersten Aufruf an Marketo rufen Sie einen Lead-Datensatz ab. Um mit Marketo arbeiten zu können, müssen Sie API-Anmeldeinformationen abrufen, um authentifizierte Aufrufe an Ihre Instanz durchführen zu können. Melden Sie sich bei Ihrer -Instanz an und gehen Sie zu Admin > Benutzer und Rollen.
Klicken Sie auf Rollen und dann auf Neue Rolle und weisen Sie mindestens die Berechtigung „Schreibgeschützter Lead“ (oder „Schreibgeschützte Person„) der Rolle in der Zugriffs-API-Gruppe zu. Geben Sie unbedingt einen beschreibenden Namen an und klicken Sie auf Erstellen.
Kehren Sie nun zur Registerkarte Benutzer zurück und klicken Sie auf Neuen Benutzer einladen. Geben Sie Ihrem Benutzer einen beschreibenden Namen, der angibt, dass er ein API-Benutzer ist, und eine E-Mail-Adresse und klicken Sie auf Weiter.
Aktivieren Sie dann die Option Nur API und weisen Sie Ihrem Benutzer die von Ihnen erstellte API-Rolle zu und klicken Sie auf Weiter.
Um die Benutzererstellung abzuschließen, klicken Sie auf Senden.
Gehen Sie dann zum Menü Admin und klicken Sie auf LaunchPoint.
Klicken Sie auf das Neu-Menü und wählen Sie Neuer Service. Geben Sie Ihrem Service einen beschreibenden Namen und wählen Sie Benutzerdefiniert aus dem Service Dropdown-Menü aus. Geben Sie eine Beschreibung ein, wählen Sie dann Ihren neuen Benutzer aus dem Dropdown-Menü Nur API und klicken Sie auf Erstellen.
Klicken Sie Details anzeigen für Ihren neuen Service, um auf die Client-ID und den geheimen Client-Schlüssel zuzugreifen. Aktuell können Sie auf die Schaltfläche Token abrufen klicken, um ein Zugriffs-Token zu generieren, das eine Stunde lang gültig ist. Speichern Sie das Token vorerst in einer Notiz.
Gehen Sie dann zum Menü Admin und dann zu Web-Services.
Suchen Sie den Endpunkt im Feld REST-API und speichern Sie ihn in einer Notiz.
Beim Aufrufen von REST-API-Methoden muss jeder Aufruf ein Zugriffstoken enthalten, damit der Aufruf erfolgreich ist. Das Zugriffstoken muss als HTTP-Kopfzeile gesendet werden.
Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
Öffnen Sie eine neue Browser-Registerkarte und geben Sie Folgendes ein, indem Sie die entsprechenden Informationen verwenden, um aufzurufen Leads nach Filtertyp abrufen
<Your Endpoint URL>/rest/v1/leads.json?&filterType=email&filterValues=<Your Email Address>
Wenn Sie keinen Lead-Eintrag mit Ihrer E-Mail-Adresse in Ihrer Datenbank haben, ersetzen Sie ihn durch einen anderen, von dem Sie wissen, dass er dort ist. Drücken Sie die Eingabetaste in Ihrer URL-Leiste und Sie sollten eine JSON-Antwort erhalten, die der folgenden ähnelt:
{
"requestId":"c493#1511ca2b184",
"result":[
{
"id":1,
"updatedAt":"2015-08-24T20:17:23Z",
"lastName":"Elkington",
"email":"developerfeedback@marketo.com",
"createdAt":"2013-02-19T23:17:04Z",
"firstName":"Kenneth"
}
],
"success":true
}