REST-API

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

Diese APIs lassen sich im Allgemeinen in zwei allgemeine Kategorien unterteilen: Lead-Datenbank und Asset. Lead-Datenbank-APIs ermöglichen das Abrufen und die Interaktion mit Marketo-Personendatensätzen und zugehörigen Objekttypen, z. B. Chancen und Unternehmen. Asset-APIs ermöglichen die Interaktion mit Marketingmaterialien und Workflow-bezogenen Datensätzen.

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

Erste Schritte

Für die folgenden Schritte sind Administratorberechtigungen in Ihrer Marketo-Instanz erforderlich.

Für Ihren ersten Marketo-Aufruf 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 wechseln Sie zu "Admin -> Benutzer und Rollen".

Klicken Sie auf die Registerkarte Rollen, dann auf "Neue Rolle"und weisen Sie mindestens die Berechtigung "Schreibgeschütztes Lead"(oder "Schreibgeschützte Person") der Rolle in der Access-API-Gruppe zu. Geben Sie einen beschreibenden Namen ein 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 anzeigt, dass es sich um einen API-Benutzer handelt, und eine E-Mail-Adresse und klicken Sie auf Weiter.

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

Um den Benutzererstellungsprozess abzuschließen, klicken Sie auf Senden.

Navigieren Sie anschließend zum Menü Admin und klicken Sie auf LaunchPoint.

Klicken Sie auf das Menü Neu und wählen Sie Neuer Dienst aus. Geben Sie Ihrem Dienst einen beschreibenden Namen und wählen Sie Benutzerdefiniert aus dem Dropdown-Menü Dienst aus. Geben Sie eine Beschreibung ein, wählen Sie dann Ihren neuen Benutzer aus dem Dropdown-Menü Nur API-Benutzer aus und klicken Sie auf Erstellen.

Klicken Sie für Ihren neuen Dienst auf Details anzeigen , um auf die Client-ID und das Client-Geheimnis zuzugreifen. Zunächst können Sie auf die Schaltfläche Token abrufen klicken, um ein Zugriffstoken zu generieren, das für eine Stunde gültig ist. Speichern Sie das Token zunächst in einer Notiz.

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

Suchen Sie den Endpunkt im Feld REST-API und speichern Sie ihn zunächst in einem Hinweis.

Bei Aufrufen von REST-API-Methoden muss in jedem Aufruf ein Zugriffstoken enthalten sein, damit der Aufruf erfolgreich ist. Das Zugriffstoken muss als HTTP-Header gesendet werden.

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int

Öffnen Sie eine neue Browser-Registerkarte und geben Sie Folgendes mit den entsprechenden Informationen ein, um Leads nach Filtertyp abrufen aufzurufen

<Your Endpoint URL>/rest/v1/leads.json?&filterType=email&filterValues=<Your Email Address>

Wenn Sie keinen Lead-Datensatz mit Ihrer E-Mail-Adresse in Ihrer Datenbank haben, ersetzen Sie ihn durch einen Datensatz, von dem Sie wissen, dass er vorhanden ist. Drücken Sie die Eingabetaste in Ihre URL-Leiste und Sie sollten eine JSON-Antwort erhalten, die dieser ä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 aufgeführt. Indem Sie Ihre Webdienste nach Benutzern aufteilen, können Sie die Nutzung jeder Ihrer Integrationen einfach erfassen. Wenn die Anzahl der API-Aufrufe an Ihre Instanz den Grenzwert überschreitet und dazu führt, dass nachfolgende Aufrufe fehlschlagen, können Sie mithilfe dieser Vorgehensweise das Volumen der einzelnen Dienste berücksichtigen und bewerten, wie das Problem gelöst werden kann. Sehen Sie sich Ihre Nutzung an, indem Sie zu Admin -> Integration > Webdienste navigieren und auf die Anzahl der Aufrufe in den letzten sieben Tagen klicken.