Códigos de erro

As APIs REST do Marketo retornam erros no nível HTTP, de resposta ou de registro. Esta página explica cada tipo de erro e lista os códigos de erro associados.

Tratando e Registrando Exceções

Registre solicitações e respostas quando a integração encontrar uma exceção inesperada. Algumas exceções, como a autenticação expirada, podem ser tratadas pela reautenticação. Outras exceções podem exigir assistência do suporte da, que solicitará os detalhes associados da solicitação e da resposta.

Tipos de erro

A API REST do Marketo pode retornar três tipos de erros durante a operação normal:

Os erros de Nível de resposta e Nível de registro retornam o código de status HTTP 200. Para todos os tipos de erro, não avalie a frase de motivo HTTP porque ela é opcional e está sujeita a alterações.

Erros de nível de HTTP

Durante a operação normal, o Marketo retorna dois erros de código de status HTTP: 413 Request Entity Too Large e 414 Request URI Too Long. Para se recuperar de qualquer erro, modifique a solicitação e tente novamente. Você pode evitar esses erros verificando os tamanhos das solicitações antes do envio.

O Marketo retorna 413 quando a carga da solicitação excede 1 MB ou 10 MB para Importar lead. Verifique o tamanho da solicitação antes de enviá-la. Se os registros fizerem com que a solicitação exceda o limite, mova esses registros para outra solicitação.

O Marketo retorna 414 quando o URI de uma solicitação GET excede 8KB. Verifique o comprimento da sequência de consulta antes do envio. Se exceder o limite, altere o método de solicitação para POST, coloque a cadeia de caracteres de consulta no corpo da solicitação e adicione o parâmetro _method=GET. URIs longos são mais comuns ao recuperar lotes de registros grandes com valores de filtro longos, como um GUID.

O ponto de extremidade Identidade pode retornar um erro 401 Não Autorizado, geralmente porque a ID do Cliente ou o Segredo do Cliente é inválido. A tabela a seguir lista códigos de erro de nível HTTP.

Erros de nível de resposta

Erros de Nível de Resposta ocorrem quando a resposta define o parâmetro success como false. Eles usam a seguinte estrutura:

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

Cada objeto na matriz “errors” contém dois membros:

Um código 6xx indica que toda a solicitação falhou e não foi executada. Por exemplo, recupere-se de um erro 601 “Token de acesso inválido” ao autenticar novamente e passar o novo token de acesso com a solicitação.

Um código 7xx indica que a solicitação falhou porque nenhum dado foi retornado ou os parâmetros de solicitação eram inválidos. As causas incluem uma data inválida ou um parâmetro obrigatório ausente.

Códigos de erro de nível de resposta

Nível de registro record_level_errors

Erros de nível de registro indicam que a solicitação era válida, mas não foi possível concluir a operação para um registro individual. Uma resposta com erros de Nível de registro segue este padrão:

Resposta

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

Os registros na matriz de resultados aparecem na mesma ordem que os registros na matriz de entrada de solicitação. Cada registro pode ter êxito ou falha independentemente, conforme indicado pelo campo de status.

Para um registro com falha, o campo “status” é “skipped” e o registro inclui uma matriz “reason”. Cada motivo contém um membro “code” e um membro “message”. O código é sempre 1xxx e a mensagem explica por que o registro foi ignorado.

Por exemplo, se uma solicitação Sincronizar clientes em potencial definir “action” como “createOnly” e um cliente em potencial já existir para uma das chaves enviadas, a resposta retornará o código 1005 e a mensagem “O cliente em potencial já existe”, como mostrado acima.

Códigos de erro de nível de registro