REST-API

Die Marketo REST-API bietet Remote-Zugriff auf viele Systemfunktionen. Sie können damit Programme erstellen, Leads stapelweise importieren und eine Marketo-Instanz auf einer detaillierten Ebene steuern.

Die REST-APIs lassen sich in zwei Kategorien einteilen:

Standard-API-Aufrufe haben eine maximale URI-Länge von 8 KB und eine maximale Textkörpergröße von 1 MB. Bulk-API-Aufrufe unterstützen eine maximale Textkörpergröße von 10 MB.

Wenn ein Aufruf einen Fehler enthält, gibt die API normalerweise dennoch den HTTP-Status-Code 200 zurück. Die JSON-Antwort enthält ein success mit dem Wert false und ein Array von Fehlern im errors. Weitere Informationen zu Fehlern finden Sie hier.

Erste Schritte

Sie benötigen Administratorrechte in Ihrer Marketo-Instanz, um die folgenden Schritte ausführen zu können. Dieser Workflow erstellt API-Anmeldeinformationen und verwendet sie zum Abrufen eines Lead-Datensatzes.

Erstellen Sie zunächst einen API-Benutzer und rufen Sie Anmeldeinformationen für authentifizierte Aufrufe ab. Melden Sie sich bei Ihrer -Instanz an und gehen Sie zu Admin > Benutzer und Rollen.

Wählen Sie die Registerkarte Rollen und dann Neue Rolle aus. Weisen Sie der Rolle mindestens die Berechtigung „Schreibgeschützter Lead“ (oder „Schreibgeschützte Person„) aus der Gruppe „Zugriffs-API“ zu. Geben Sie der Rolle einen beschreibenden Namen und wählen Sie Erstellen.

Kehren Sie zur Registerkarte Benutzer zurück und wählen Sie Neuen Benutzer einladen aus. Geben Sie einen beschreibenden Namen ein, der den Benutzer als API-Benutzer identifiziert, geben Sie eine E-Mail-Adresse ein und wählen Sie Weiter.

Wählen Sie die Option Nur API, weisen Sie die von Ihnen erstellte API-Rolle zu und klicken Sie auf Weiter.

Wählen Sie Senden aus, um den Benutzer zu erstellen.

Gehen Sie dann zum Menü Admin und wählen Sie LaunchPoint aus.

Wählen Sie Neu > Neuer Service. Geben Sie einen beschreibenden Namen und eine Beschreibung ein und wählen Sie Benutzerdefiniert aus dem Menü Service aus. Wählen Sie den neuen Benutzer aus dem Menü Nur API und klicken Sie dann auf Erstellen.

Wählen Sie Details anzeigen für den neuen Service aus, um auf die Client-ID und das Client-Geheimnis zuzugreifen. Wählen Sie Token abrufen, um ein Zugriffstoken zu generieren, das eine Stunde gültig ist. Speichern Sie das Token für den ersten API-Aufruf.

Navigieren Sie Admin > Web-Services.

Suchen Sie den Endpunkt im Feld REST-API und speichern Sie ihn für den ersten API-Aufruf.

Jeder REST-API-Aufruf muss ein Zugriffstoken in einer HTTP-Kopfzeile enthalten.

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

Öffnen Sie eine neue Browser-Registerkarte und geben Sie die folgende URL ein. Ersetzen Sie die Platzhalter durch den Endpunkt und die E-Mail-Adresse für Ihre Instanz, um „Leads ​ Filtertyp abrufen aufzurufen.

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

Wenn Ihre Datenbank keinen Lead-Eintrag mit Ihrer E-Mail-Adresse enthält, verwenden Sie die E-Mail-Adresse eines bestehenden Leads. Senden Sie die URL, um eine JSON-Antwort ähnlich dem folgenden Beispiel zu erhalten:

{
    "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

Der API-Nutzungsbericht verfolgt jeden API-Benutzer separat. Wenn Sie jedem Webservice einen separaten Benutzer zuweisen, können Sie die API-Nutzung jeder Integration identifizieren.

Wenn -Aufrufe das Limit Ihrer Instanz überschreiten und nachfolgende -Aufrufe fehlschlagen, verwenden Sie den Bericht, um das Aufrufvolumen aus jedem Service zu identifizieren. Navigieren Sie Admin > Integration > Web-Services und wählen Sie die Anzahl der Aufrufe aus, die in den letzten sieben Tagen getätigt wurden.

Die REST-Endpunkte, die die täglichen und die Nutzungs- und Fehlerstatistiken der letzten 7 Tage zurückgeben, finden Sie unter Nutzung.