Manipulação de erros

• 207 Multi-Status: retornado quando há status diferentes (por exemplo, erros e êxitos), que ocorre quando você habilita tratamento de erros de vários status para o objeto API batch criar pontos de extremidade.
• 401 Unauthorized: retornado quando a autenticação fornecida é inválida. Veja nossa Visão geral de autenticação para obter detalhes sobre as solicitações de API autenticadas.
• 403 Forbidden: retornado quando a autenticação fornecida não tem as permissões adequadas para acessar a URL específica. Como exemplo, um token de OAuth que só tem acesso de conteúdo receberá um 403 ao acessar a API Negócios (que exige acesso de contatos). Se você confirmou que sua chave de API ou aplicativo privado tem as permissões necessárias, entre em contato com o suporte da HubSpot para obter assistência.
• 423 Locked: retornado ao tentar sincronizar um grande volume de dados (por exemplo, inserir milhares de registros de empresas em um período muito curto de tempo). Os bloqueios duram 2 segundos, então se você receber um erro 423, você deve incluir um atraso de pelo menos 2 segundos entre suas solicitações de API.
• 429 Too many requests: retornado quando a conta ou o aplicativo está acima de seus limites de taxa de API. Encontre sugestões em trabalhar dentro desses limites aqui.
• 477 Migration in Progress: retornado quando uma conta da HubSpot está sendo migrada entre locais de hospedagem de dados. O HubSpot retornará o cabeçalho de resposta Retry-After, que indica o número de segundos após os quais a solicitação será repetida (normalmente até 24 horas).
• 502/504 timeouts: retornado quando os limites de processamento da HubSpot foram atendidos. Esses limites estão em vigor para impedir que um único cliente cause redução de desempenho. Essas respostas de tempo limite ocorrem ao fazer um grande número de solicitações ao longo de um período prolongado. Se você receber uma dessas respostas, você deve pausar suas solicitações por alguns segundos e tentar novamente.
• 503 service temporarily unavailable: retornado quando a HubSpot está temporariamente indisponível. Se você receber essa resposta, deve pausar suas solicitações por alguns segundos e tentar novamente.
• 521 web server is down: retornado quando o servidor da HubSpot está inativo. Isso deve ser um problema temporário. Se você receber essa resposta, deve pausar suas solicitações por alguns segundos e tentar novamente.
• 522 connnection timed out: retornado quando a conexão entre a HubSpot e o aplicativo atingiu o tempo limite. Se você recebeu essa resposta, entre em contato com o suporte da HubSpot para obter assistência.
• 523 origin is unreachable: retornada quando a HubSpot não consegue entrar em contato com seu aplicativo. Se você receber essa resposta, deve pausar suas solicitações por alguns segundos e tentar novamente.
• 524 timeout: retornado quando uma resposta não é recebida dentro de 100 segundos. Isso pode ocorrer quando o servidor do HubSpot está sobrecarregado, como com uma consulta de dados grande. Se você receber essa resposta, deve pausar suas solicitações por alguns segundos e tentar novamente.
• 525/526 SSL issues: retornado quando o certificado SSL é inválido ou o aperto de mão SSL falha. Se você recebeu essa resposta, entre em contato com o suporte da HubSpot para obter assistência.

• Para APIs de objeto do CRM, as respostas de erro incluirão informaçõesmessage codee contextcampos que fornecerão informações adicionais sobre as propriedades necessárias que não foram incluídas em sua solicitação, bem como quaisquer problemas com propriedades malformadas em sua solicitação.
• Mais detalhes para erros específicos de ponto de extremidade podem ser encontrados nas páginas de documentação para o final.

// Structure of an example error from HubSpot
{
  "status": "error",
  "message": "This will be a human readable message with details about the error.",
  "errors": [
    {
      "message": "discount was not a valid number",
      "code": "INVALID_INTEGER",
      "context": {
        "propertyName": ["discount"]
      }
    }
  ],
  "category": "VALIDATION_ERROR",
  "correlationId": "a43683b0-5717-4ceb-80b4-104d02915d8c"
}

​

Erros de vários status

///Example request to POST crm/v3/objects/tickets/batch/create
{
  "inputs": [
    {
      "objectWriteTraceId": "549b1c2a9350",
      "properties": {
        "hs_pipeline_stage": "1"
      },
      "objectWriteTraceId": "549b1c2a9351",
      "properties": {
        "missing": "1"
      }
    }
  ]
}

///Example response
{
  "status": "COMPLETE",
  "results": [
    {
      "id": "1145814089",
      "properties": {
        "createdate": "2024-08-15T17:09:13.648Z",
        "hs_helpdesk_sort_timestamp": "2024-08-15T17:09:13.648Z",
        "hs_last_message_from_visitor": "false",
        "hs_lastmodifieddate": "2024-08-15T17:09:13.648Z",
        "hs_object_id": "1145814089",
        "hs_object_source": "API",
        "hs_object_source_label": "INTERNAL_PROCESSING",
        "hs_pipeline": "0",
        "hs_pipeline_stage": "1",
        "hs_ticket_id": "1145814089"
      },
      "createdAt": "2024-08-15T17:09:13.648Z",
      "updatedAt": "2024-08-15T17:09:13.648Z",
      "archived": false
    }
  ],
  "numErrors": 1,
  "errors": [
    {
      "status": "error",
      "category": "VALIDATION_ERROR",
      "message": "Property values were not valid: [{\"isValid\":false,\"message\":\"Property \\\"missing\\\" does not exist\",\"error\":\"PROPERTY_DOESNT_EXIST\",\"name\":\"missing\",\"localizedErrorMessage\":\"Property \\\"missing\\\" does not exist\",\"portalId\":891936587}]",
      "context": {
        "objectWriteTraceId": ["549b1c2a9351"]
      }
    }
  ],
  "startedAt": "2024-08-15T17:09:13.610Z",
  "completedAt": "2024-08-15T17:09:13.910Z"
}

​

Tentativas

​

Webhooks

• Falha na conexão: se a HubSpot não conseguir estabelecer uma conexão http com a URL do webhook fornecida.
• Tempo limite: se o serviço demorar mais de 5 segundos para enviar uma resposta a um lote de notificações
• Códigos de erro: seu serviço responde com qualquer código de status HTTP (4xx ou 5xx)

​

Ações de fluxo de trabalho de código personalizado