Gerar Autenticação oAuth (Access Token)

Sumário

Descrição
Endpoints
Requisição (POST)
- Parâmetros de Requisição
  - Cabeçalho
  - Corpo (JSON)
Resposta
- Parâmetros de Resposta
  - Corpo (JSON)

Descrição #

Para viabilizar as chamadas à API, é necessário chamar o método de inicialização que gera o token de acesso que será usado nas próximas chamadas. Deverá ser feita uma requisição HTTP do tipo POST à URL do oAuth:

Endpoints #

Produção: https://api2.bancosemear.com.br/oauth/access-token
Homologação: https://hmlapi2.bancosemear.com.br/oauth/access-token

Requisição (POST) #

Segue exemplo de requisição:

curl https://api2.bancosemear.com.br/oauth/access-token \
    --request POST \
    --header "Content-Type: application/json" \
    --header "Authorization: Basic MDAwMDAwMDAtMTExMS0yMjIyLTMzMzMtNDQ0NDQ0NDQ0NDQ6YWFhYWFhYWEtYmJiYi1jY2NjLWRkZGQtZWVlZWVlZWVlZWVlCg==" \
    --data '{"grant_type":"client_credentials"}'

Parâmetros de Requisição #

Cabeçalho #

Content-Type: Tipo do corpo da requisição. Obrigatório ser application/json
Authorization: Autenticação básica composta do client_id + client_secret separados pelo caracter “:” (dois pontos) e codificados em base64. Passado no header Basic XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX. Parâmetro obrigatório

Corpo (JSON) #

grant_type: Tipo de solicitação oAuth. Obrigatório ser client_credentials

Resposta #

Segue exemplo de resposta:

{
    "access_token":"aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
    "token_type":"access_token",
    "expires_in":86400
}

Parâmetros de Resposta #

Corpo (JSON) #

access_token: Token de acesso. Deverá ser utilizado como parâmetro do cabeçalho em todas as demais solicitações
token_type: Tipo do token
expires_in: Tempo de expiração do token em segundos