Codes d’erreur

Les API REST Marketo renvoient des erreurs au niveau du HTTP, de la réponse ou de l’enregistrement. Cette page décrit chaque type d’erreur et répertorie les codes d’erreur associés.

Gestion et journalisation des exceptions

Enregistrez les requêtes et les réponses lorsque votre intégration rencontre une exception inattendue. Certaines exceptions, telles que l’authentification expirée, peuvent être gérées en s’authentifiant à nouveau. D’autres exceptions peuvent nécessiter l’aide de l’assistance , qui demande les détails de requête et de réponse associés.

Types d’erreurs

L’API REST Marketo peut renvoyer trois types d’erreurs lors d’un fonctionnement normal :

Les erreurs de niveau réponse et de niveau enregistrement renvoient le code d’état HTTP 200. Pour tous les types d’erreur, n’évaluez pas l’expression de raison HTTP, car elle est facultative et peut être modifiée.

Erreurs au niveau du HTTP

En fonctionnement normal, Marketo renvoie deux erreurs de code d’état HTTP : 413 Request Entity Too Large et 414 Request URI Too Long. Pour récupérer après l’une de ces erreurs, modifiez la requête et réessayez. Vous pouvez éviter ces erreurs en vérifiant les tailles des requêtes avant l’envoi.

Marketo renvoie la valeur 413 lorsque la payload de la requête dépasse 1 Mo, ou 10 Mo pour le prospect d’importation. Vérifiez la taille de la requête avant l’envoi. Si des enregistrements entraînent un dépassement de la limite de la demande, déplacez ces enregistrements vers une autre demande.

Marketo renvoie la valeur 414 lorsque l’URI d’une requête GET dépasse 8 Ko. Vérifiez la longueur de la chaîne de requête avant l’envoi. S’il dépasse la limite, définissez la méthode de requête sur POST, placez la chaîne de requête dans le corps de la requête et ajoutez le paramètre _method=GET. Les URI longs sont les plus courants lors de la récupération de lots d’enregistrements volumineux avec de longues valeurs de filtre, telles qu’un GUID.

Le point d’entrée Identity peut renvoyer une erreur 401 Non autorisé, généralement parce que l’ID client ou le secret client n’est pas valide. Le tableau suivant répertorie les codes d’erreur de niveau HTTP.

Erreurs de niveau de réponse

Les erreurs de niveau de réponse se produisent lorsque la réponse définit le paramètre success sur false. Ils utilisent la structure suivante :

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

Chaque objet du tableau « errors » contient deux membres :

Un code 6xx indique que la requête entière a échoué et n’a pas été exécutée. Par exemple, récupérez-vous d’une erreur 601 « Jeton d’accès non valide » en vous authentifiant à nouveau et en transmettant le nouveau jeton d’accès avec la requête.

Un code 7xx indique que la requête a échoué, car aucune donnée n’a été renvoyée ou que les paramètres de requête n’étaient pas valides. Les causes incluent une date non valide ou un paramètre obligatoire manquant.

Codes d’erreur au niveau de la réponse

Record-Level record_level_errors

Les erreurs au niveau de l’enregistrement indiquent que la demande était valide mais que l’opération n’a pas pu être effectuée pour un enregistrement individuel. Une réponse contenant des erreurs au niveau des enregistrements suit ce modèle :

Réponse

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

Les enregistrements du tableau de résultats apparaissent dans le même ordre que les enregistrements du tableau d’entrée de requête. Chaque enregistrement peut réussir ou échouer indépendamment, comme indiqué par son champ de statut.

Pour un enregistrement en échec, le champ « statut » est « ignoré » et l’enregistrement inclut un tableau « raisons ». Chaque raison contient un membre « code » et un membre « message ». Le code est toujours 1xxx et le message explique pourquoi l’enregistrement a été ignoré.

Par exemple, si une requête Synchroniser les leads définit « action » sur « createOnly » et qu’un lead existe déjà pour l’une des clés envoyées, la réponse renvoie le code 1005 et le message « Lead existe déjà », comme illustré ci-dessus.

Codes D’Erreur Au Niveau De L’Enregistrement