Autenticação
Obtenção de token JWT para autorização de requisições.

Overview

Para iniciar o processo de integração com a API da Preme Pay, você vai precisar primeiro fazer o procedimento de autenticação. A autenticação é a etapa que permite que você se conecte com serviços oferecidos pela Preme Pay.
Para passar por esta etapa, primeiro você precisa solicitar o token de autorização, para isso a API utiliza as informações de usuário e senha. As informações são encaminhadas pelo corpo da requisição e, após serem processadas pelo servidor retornaram um status e um objeto JSON como resposta.
O retorno varia de acordo com o código de status de respostas HTTP. Caso a requisição tenha sido bem sucedida você receberá o retorno de status 200 como resposta. Além disso, seu objeto retornado vai também disponibilizar o nome de usuário, o token que será usando nas demais requisições da API e uma data de expiração desse token.
O Token de Autenticação tem validade de 60 minutos. Após esse prazo expirado é necessário autenticar-se novamente.

Autenticação

https://api.premepay.com/v1/authentication
Parâmetro
Tipo
username
string
password
string

Exemplo de Requisição

Este é um exemplo de como a sua requisição para autenticação deve parecer. Você deve submeter uma requisição semelhante a esta para receber o token de autorização.
{
"username": "[email protected]",
"password": "123456"
}

Lista de Respostas para Requisição

200: Approved

Esta é a resposta para os casos em que sua requisição seja bem sucedida.
{
"username": "Carlos",
"token": "jb20iLCJwYXNzd29yWh5NHd6dnV2YjQifQ.yN_8-",
"expiryAt": "2020-07-21T12:37:16.507Z"
}

404: User Not found

Esta é a resposta para os casos em que seu usuário não foi encontrado. Este é um código de resposta HTTP que indica que houve comunicação entre a requisição e o servidor, entretanto o servidor não conseguiu encontrar o que foi requerido.
{
"error": {
"message": "User not found"
}
}

500: Internal Server Error

Esta é a resposta para os casos em que ocorre um erro interno no servidor.
{
"error": {
"message": "Internal server error"
}
}
Quer entender o significado dos códigos de resposta? Clique aqui para acessar os Códigos de Erro da API da Preme Pay.
Copy link
Outline
Overview
Autenticação