Depois que um usuário autorizar seu aplicativo, você receberá um código, que deverá ser utilizado para obter um token de acesso e um token de atualização. O token de acesso será usado para autenticar solicitações feitas pelo aplicativo. Os tokens de acesso expiram após seis horas. Então, quando o primeiro token de acesso expirar, você poderá usar o endpoint do token de atualização para obter um novo token de acesso.
Para gerar um novo token de acesso, use um token de atualização obtido anteriormente. Os tokens de acesso expiram após seis horas. Se precisar de acesso off-line aos dados da HubSpot, armazene o token de atualização obtido quando você inicia a integração do OAuth e utilize-o para gerar um novo token de acesso depois que o token inicial expira
Observação: O tamanho dos tokens de acesso da HubSpot variarão à medida que alterarmos as informações que são codificadas. Recomendamos que os tokens tenham até 300 caracteres para acomodar quaisquer alterações.
Obtenha os metadados de um token de acesso ou de atualização. Ele pode ser usado para obter o endereço de e-mail do usuário do HubSpot para o qual o token foi criado, bem como o ID do Hub a que o token está associado.
Exclui um token de atualização. Você pode usá-lo para excluir o token de atualização caso um usuário desinstale o aplicativo.
Observação: Isso excluirá apenas o token de atualização. Os tokens de acesso gerados com o token de atualização não serão afetados. Além disso, isso não desinstalará um aplicativo de uma conta da HubSpot nem impedirá a sincronização de dados entre uma conta e um aplicativo conectado.
// Authorization: Bearer {token}
curl --request GET \
--url 'https://api.hubapi.com/crm/v3/objects/contacts?limit=10&archived=false' \
--header 'authorization: Bearer CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4'
{contacts: .....}
Neste exemplo, o token de acesso é:
CJSP5qf1KhICAQEYs-gDIIGOBii1hQIyGQAf3xBKmlwHjX7OIpuIFEavB2-qYAGQsF4
Observações: Se estiver usando tokens de acesso OAuth 2.0, você não deverá incluir hapikey=
no URL de solicitação. O cabeçalho de autorização é usado em substituição a esse parâmetro de consulta.