Token de autenticação

Obtendo um Token de Autenticação

Para realizar integrações via API com o CRM PipeRun, é necessário obter um token de autenticação de usuário. Este token pode ser encontrado dentro da plataforma na tela do usuário, a esquerda, logo abaixo da sua foto.

Observação: Nossos tokens são gerados exclusivamente para usuários ativos na plataforma. Ou seja, para obter e utilizar um token, é necessário possuir um usuário ativo vinculado a uma conta ativa no PipeRun.

Como utilizar o Token

Para autenticar suas requisições, inclua o token no cabeçalho de cada requisição.
Veja o exemplo utilizando curl:

curl -sS -X GET -H "token: SEU_TOKEN_AQUI" https://api.pipe.run/v1

Caso você receba a mensagem abaixo, revise se o token está correto.

{
  "success": false,
  "message": "Unauthorized"
}

Você deve receber uma mensagem contendo esta informação, então você está pronto para prosseguir.

{
  "success": true,
  "message": "OK",
  "data": {
    "name": "PipeRun API",
    "version": "1.1",
    "documentation": "https://developers.pipe.run/",
    "account_id": 1,
    "user_id": 123,
    "user_email": "[email protected]",
    "user_acl": "G1"
  }
}

Segurança do token

• O token é único para cada usuário e garante acesso a todas as funcionalidades permitidas ao seu usuário.
• Mantenha seu token seguro! Não compartilhe, exponha ou armazene o token em locais públicos ou inseguros.
• Vazamento do token compromete toda a sua conta. Utilize o token apenas em ambientes confiáveis.
• Em caso de suspeita de vazamento ou acesso indevido, entre em contato imediatamente com o suporte técnico > do PipeRun para revogar o token e garantir a segurança de sua conta.