Estes são tokens JSON Web Token (JWT) que podem ser transferidos junto com uma solicitação para recursos de terceiros a partir da interface Web do Kommo.

O token contém informações criptografadas sobre o usuário que fez uma solicitação para um recurso.

Como obtenho um token de uso único?

O método envia uma solicitação AJAX com um token de autorização temporário para o usuário atual.

O cabeçalho X-Auth-Token é adicionado à solicitação. O servidor remoto deve conceder permissão para receber solicitações do domínio da conta (configurar CORS).

O método herda todos os parâmetros de entrada da função jQuery $.ajax() e, em resposta, também retorna um objeto do tipo jQuery $.Deferred, totalmente compatível com a resposta do método $.ajax.

define([], function() {
  'use strict';
  return function() {
    var self = this;
    this.callbacks = {
      init: function() {
        return true;
      },
      render: function() {
        self.$authorizedAjax({
          url: 'https://example.com/'// fornecer a URL onde você deseja obter seu token
        }).done(function (response) {
          console.log('sucesso', response);
        }).fail(function (err) {
          console.log('erro', err);
        });
        return true;
      },
      bind_actions: function() {
        return true;
      }
    };
    return this;
  };
});

Algoritmo de decodificação de token

O algoritmo de assinatura do token é o HS256.

A chave secreta da integração é utilizada como a chave de criptografia (somente o proprietário da integração tem acesso a essa chave).

Para decifrar o token, recomendamos o uso dos métodos das bibliotecas públicas. Você também pode usar o depurador para decifrar, validar e gerar o JWT (JSON Web Token).

Parâmetros do token após a decodificação

Parâmetro	Tipo de Dado	Descrição
iss	string	Endereço da conta Kommo
aud	string	O endereço base é formado com base no valor de `redirect_uri` na integração.
jti	string	Token UUID
iat	int	Data em que o token foi emitido no formato de Timestamp (Carimbo de data e hora) Unix.
nbf	int	Data em que o token se torna válido no formato de Timestamp (Carimbo de data e hora) Unix.
exp	int	Data em que o token expirará no formato de Timestamp (Carimbo de data e hora)Unix.
account_id	int	ID da conta a partir da qual a solicitação foi feita.
user_id	int	ID do usuário que fez a solicitação.
client_uuid	string	O UUID da integração que fez a solicitação.

Exemplo de resposta

{
    "iss": "https://subdomain.kommo.com",
    "aud": "https://external.integration.io",
    "jti": "d123f123-5123-b123-a123-ed123ef123f",
    "iat": 1594204245,
    "nbf": 1594204245,
    "exp": 1594206045,
    "account_id": 12345678,
    "user_id": 87654321,
    "subdomain": "subdomínio",
    "client_uuid": "0b0123f4-d123-4123-9123-e09f123456c"
}