POST/api/v2/auth/refresh

Refresh Token

Renova o Bearer token sem novo login. Envie o access_token atual (ainda válido ou dentro da janela aceita) em Authorization: Bearer {{access_token}}. Não há corpo na requisição.

A resposta traz um novo access_token com novo expires_in. Substitua o token armazenado no cliente. Guia: Refresh.

Renova o token Bearer sem refazer o login. Não envie corpo: use o access_token atual no header Authorization: Bearer {{access_token}}.

Resposta (200)

CampoTipoDescrição
access_tokenstringNovo token para Authorization: Bearer ...
token_typestringGeralmente Bearer
expires_inintValidade em segundos (tipicamente 3600)

Substitua o token anterior pelo novo valor retornado. Se o refresh falhar com 401, faça login novamente.

Guia: Refresh.

curl --location --request POST 'https://api-h.nuvende.com.br/api/v2/auth/refresh' \
--header 'Authorization: Bearer {{access_token}}'
const axios = require("axios");

axios({
  method: "post",
  url: "https://api-h.nuvende.com.br/api/v2/auth/refresh",
  headers: {
    Authorization: "Bearer {{access_token}}",
  },
})
  .then((response) => console.log(JSON.stringify(response.data)))
  .catch((error) => console.log(error.response?.data || error.message));
import requests

url = "https://api-h.nuvende.com.br/api/v2/auth/refresh"
headers = {"Authorization": "Bearer {{access_token}}"}

response = requests.post(url, headers=headers)
print(response.text)
<?php
$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-h.nuvende.com.br/api/v2/auth/refresh",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer {{access_token}}"],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>
{
  "access_token": "{{access_token}}",
  "token_type": "Bearer",
  "expires_in": 3600
}
{
  "message": "Invalid token",
  "error": ["invalid_token"]
}

Após o 200, use o novo access_token nas requisições seguintes.