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.

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.

Neue Rolle

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.

Neue Benutzerinformationen

Aktivieren Sie dann die Option Nur API und weisen Sie Ihrem Benutzer die von Ihnen erstellte API-Rolle zu und klicken Sie auf Weiter.

Berechtigungen für neue Benutzer

Um die Benutzererstellung abzuschließen, klicken Sie auf Senden.

Nachricht für neuen Benutzer

Gehen Sie dann zum Menü Admin und klicken Sie auf LaunchPoint.

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.

Neuer Launchpoint-Service

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.

Token abrufen

Gehen Sie dann zum Menü Admin und dann zu Web-Services.

Web-Services

Suchen Sie den Endpunkt im Feld REST-API und speichern Sie ihn in einer Notiz.

REST-Endpunkt

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
IMPORTANT
Die Unterstützung für die Authentifizierung mit dem access_token-Abfrageparameter wird am 30. Juni 2025 entfernt. Wenn Ihr Projekt einen Abfrageparameter verwendet, um das Zugriffstoken zu übergeben, sollte es so bald wie möglich aktualisiert werden, um die Authorization-Kopfzeile zu verwenden. Für die neue Entwicklung sollte ausschließlich der Authorization-Header verwendet werden.

Ö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
}