Fehler-Codes

Marketo-REST-APIs geben Fehler auf HTTP-, Antwort- oder Datensatzebene zurück. Auf dieser Seite werden die einzelnen Fehlertypen erläutert und die zugehörigen Fehler-Codes aufgelistet.

Behandeln und Protokollieren von Ausnahmen

Anfragen und Antworten protokollieren, wenn bei Ihrer Integration eine unerwartete Ausnahme auftritt. Einige Ausnahmen, z. B. abgelaufene Authentifizierungen, können durch eine erneute Authentifizierung behandelt werden. Für andere Ausnahmen ist möglicherweise die Unterstützung des Supports erforderlich, der die zugehörigen Anfrage- und Antwortdetails anfordert.

Fehlertypen

Die Marketo-REST-API kann während des normalen Betriebs drei Fehlertypen zurückgeben:

Fehler auf Antwort- und Datensatzebene geben den HTTP-Status-Code 200 zurück. Bewerten Sie die HTTP-Ursachenphrase nicht für alle Fehlertypen, da sie optional ist und sich ändern kann.

Fehler auf HTTP-Ebene

Während des normalen Betriebs gibt Marketo zwei HTTP-Status-Code-Fehler zurück: 413 Request Entity Too Large und 414 Request URI Too Long. Um einen der Fehler zu beheben, ändern Sie die Anfrage und versuchen Sie es erneut. Sie können diese Fehler verhindern, indem Sie die Anfragengrößen vor der Übermittlung überprüfen.

Marketo gibt 413 zurück, wenn die Anfrage-Payload 1 MB oder 10 MB für den Import-Lead überschreitet. Überprüfen Sie die Anfragengröße vor der Übermittlung. Wenn die Anfrage aufgrund von Datensätzen das Limit überschreitet, verschieben Sie diese Datensätze in eine andere Anfrage.

Marketo gibt 414 zurück, wenn der URI einer GET-Anfrage 8 KB überschreitet. Überprüfen Sie die Länge der Abfragezeichenfolge vor der Übermittlung. Wenn es das Limit überschreitet, ändern Sie die Anfragemethode in POST, fügen Sie die Abfragezeichenfolge in den Anfragetext ein und fügen Sie den _method=GET Parameter hinzu. Lange URIs sind am häufigsten beim Abrufen großer Datensatz-Batches mit langen Filterwerten, wie z. B. einer GUID.

Der Identity-Endpunkt kann einen 401-Fehler „Nicht autorisiert“ zurückgeben, in der Regel weil die Client-ID oder das Client-Geheimnis ungültig ist. Die folgende Tabelle listet Fehler-Codes auf HTTP-Ebene auf.

Fehler auf Antwortebene

Fehler auf Antwortebene treten auf, wenn in der Antwort der success auf „false“ gesetzt wird. Sie verwenden die folgende Struktur:

{
    "requestId": "e42b#14272d07d78",
    "success": false,
    "errors": [
        {
            "code": "601",
            "message": "Unauthorized"
        }
    ]
}

Jedes Objekt im Array „errors“ enthält zwei Elemente:

Ein 6xx-Code gibt an, dass die gesamte Anfrage fehlgeschlagen ist und nicht ausgeführt wurde. Stellen Sie beispielsweise einen 601-Fehler „Ungültiges Zugriffstoken“ wieder her, indem Sie sich erneut authentifizieren und das neue Zugriffstoken mit der Anfrage übergeben.

Ein 7xx-Code gibt an, dass die Anfrage fehlgeschlagen ist, da keine Daten zurückgegeben wurden oder die Anfrageparameter ungültig waren. Zu den Ursachen gehören ein ungültiges Datum oder ein fehlender erforderlicher Parameter.

Fehlercodes auf Antwortebene

auf Rekordebene record_level_errors

Fehler auf Datensatzebene zeigen an, dass die Anfrage gültig war, der Vorgang für einen einzelnen Datensatz jedoch nicht abgeschlossen werden konnte. Eine Antwort mit Fehlern auf Datensatzebene folgt diesem Muster:

Antwort

{
   "requestId":"e42b#14272d07d78",
   "success":true,
   "result":[
      {
         "id":50,
         "status":"created"
      },
      {
         "id":51,
         "status":"created"
      },
      {
         "status":"skipped",
         "reasons":[
            {
               "code":"1005",
               "message":"Lead already exists"
            }
         ]
      }
   ]
}

Die Datensätze im Ergebnis-Array werden in der gleichen Reihenfolge wie die Datensätze im Anforderungseingabe-Array angezeigt. Jeder Datensatz kann unabhängig erfolgreich sein oder fehlschlagen, wie durch sein Statusfeld angegeben.

Bei einem fehlgeschlagenen Datensatz wird das Feld „Status“ „übersprungen“ und der Datensatz enthält ein Array „Gründe“. Jeder Grund enthält ein Element des Typs „Code“ und ein Element des Typs „Nachricht“. Der Code ist immer 1xxx. In der Meldung wird erläutert, warum der Datensatz übersprungen wurde.

Wenn beispielsweise eine Anfrage zur Lead-Synchronisierung „Aktion“ auf „createOnly“ setzt und bereits ein Lead für einen der gesendeten Schlüssel vorhanden ist, gibt die Antwort den Code 1005 und die Nachricht „Lead existiert bereits“ zurück, wie oben gezeigt.

Fehlercodes auf Datensatzebene