REST-API

Marketo stellt eine REST-API bereit, die die Remote-Ausführung vieler Systemfunktionen ermöglicht. Von der Erstellung von Programmen bis zum Massenimport von Leads gibt es viele Optionen, die eine feinkörnige Steuerung einer Marketo-Instanz ermöglichen.

Diese APIs lassen sich im Allgemeinen in zwei Kategorien einteilen „Lead-" und Asset. Lead-Datenbank-APIs ermöglichen das Abrufen und Interagieren von Marketo-Personendatensätzen und zugehörigen Objekttypen wie Opportunities und Unternehmen. Asset-APIs ermöglichen die Interaktion mit Marketing-Material und Workflow-bezogenen Datensätzen.

Die Größe von Standardaufrufen ist auf eine URI-Länge von 8 KB und eine Textkörpergröße von 1 MB beschränkt, obwohl der Textkörper für unsere Bulk-APIs 10 MB betragen kann. Wenn in bei Ihrem Aufruf ein Fehler auftritt, gibt die API normalerweise trotzdem den Status-Code 200 zurück, aber die JSON-Antwort enthält ein „success“-Element mit dem Wert false und ein Array von Fehlern im „errors“-Element. Weitere Informationen zu Fehlern hier.

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
}

API-Nutzung

Jeder Ihrer API-Benutzer wird einzeln im API-Nutzungsbericht gemeldet, sodass Sie durch die Aufspaltung Ihrer Web-Services nach Benutzer einfach die Nutzung jeder Ihrer Integrationen erfassen können. Wenn die Anzahl der API-Aufrufe an Ihre Instanz das Limit überschreitet und nachfolgende Aufrufe fehlschlagen, können Sie mit dieser Vorgehensweise das Volumen aus jedem Ihrer Services berücksichtigen und bewerten, wie Sie das Problem beheben können. Überprüfen Sie Ihre Nutzung, indem Sie zu Admin -> Integration > Web-Services wechseln und auf die Anzahl der Aufrufe in den letzten sieben Tagen klicken.