Skip to main content

​
Endpoint de Autenticação

Método: POST
URL: https://api.robbu.global/v1/login
Body
{
    "Company": "#####",
    "Username": "#####",
    "Password": "#####"
}

​
Parâmetros da Requisição

ParâmetroTipoObrigatórioDescriçãoExemplo
CompanystringSimNome da empresa no ambiente Invenio.Robbu
UsernamestringSimNome de usuário para autenticação.usuario_teste
PasswordstringSimSenha associada ao usuário.senha_secreta

​
Exemplo de response

{ 
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5...", 
  "expires_in": 287971200, 
  "refresh_token": "", 
  "token_type": "bearer" 
}

​
Campos do Response

CampoDescrição
access_tokenToken de acesso utilizado para autenticar as próximas requisições às APIs.
expires_inTempo de expiração do token, em segundos.
token_typeTipo do token retornado, que deve ser informado no header das requisições.
Não é necessário gerar um novo token de forma recorrente. O campo expires_in informa o tempo de validade do token em segundos e, por padrão, ele pode ser considerado válido por até 3333 dias. Vale ressaltar que, ao realizar uma nova chamada à rota de login, o token anteriormente emitido será automaticamente invalidado, passando a valer apenas o token mais recente.

​
🔗 Links e assuntos relacionados

​
⁉️ Perguntas Frequentes (FAQ)

Usuários do tipo Integração API são destinados exclusivamente a integrações sistêmicas e não realizam login interativo na plataforma.Quando credenciais de usuários que acessam a plataforma regularmente são utilizadas para autenticação via API, pode ocorrer a geração de um novo token a cada login na interface. Como consequência, o token anteriormente emitido para integrações é invalidado automaticamente.Esse comportamento pode gerar expiração inesperada do token utilizado por outras integrações ativas, ocasionando falhas de autenticação e indisponibilidade nos serviços integrados.Por esse motivo, recomenda-se sempre a utilização de usuários do tipo API, garantindo estabilidade, isolamento de acesso e maior previsibilidade no funcionamento das integrações.
O token retornado no campo access_token deve ser enviado no header das requisições no seguinte formato:
Authorization: Bearer {access_token}
O valor deve respeitar o token_type retornado no response. Por padrão utilizamos o tipo bearer token.
Não. O token possui validade definida pelo campo expires_in (em segundos).Por padrão, ele pode ser considerado válido por até 3333 dias, não sendo necessário gerar tokens de forma recorrente.
O token anterior será automaticamente invalidado. Isso significa que apenas o token mais recente permanecerá válido.
A API retornará erro de autenticação (401 – Unauthorized), indicando que é necessário gerar um novo Token de acesso válido.
Sim. No entanto, é importante lembrar que, se uma das integrações gerar um novo token via login, o token anterior será invalidado para todas.