Renovar token de acesso

POST /api/auth/v1/token/refresh

O que este endpoint faz

Este endpoint renova o token de acesso para manter a integração autenticada sem exigir novo login completo. Ele pertence ao domínio de autenticação, sessão e identificação do usuário que consome a plataforma.

Use POST /api/auth/v1/token/refresh quando a integração precisar acionar esse comportamento exatamente como o app da Antecipa Fácil faz pelo gateway público.

Para que serve

Ele ajuda a compor fluxos de integração do backend do parceiro com a plataforma, mantendo autenticação via Bearer token e tráfego pelo APIM. Consulte os parâmetros, corpo de requisição e respostas desta página antes de usar em produção.

Gateway

Chame sempre https://api.antecipafacil.net.br/api/auth/v1/token/refresh. O APIM repassa a rota para o backend correto; serviços internos não devem ser chamados diretamente.

Parâmetros

Este endpoint não declara parâmetros adicionais na especificação OpenAPI.

Corpo da requisição

Envie o payload em JSON conforme o contrato do backend.

{
  "refresh": "<refresh>"
}

Respostas

201 Operação executada com sucesso.

Try it POST

URL Bearer token Body JSON { "refresh": "<refresh>" } Try it!

Clique em Try it! para executar a chamada pelo navegador.

Exemplos

ShellNodeDenoPythonC#Rust

curl --request POST \
  --url 'https://api.antecipafacil.net.br/api/auth/v1/token/refresh' \
  --header 'accept: application/json' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'content-type: application/json' \
  --data '{
  "refresh": "<refresh>"
}'

const response = await fetch('https://api.antecipafacil.net.br/api/auth/v1/token/refresh', {
  method: 'POST',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
  "refresh": "<refresh>"
}),
});

const data = await response.json();
console.log(data);

const response = await fetch('https://api.antecipafacil.net.br/api/auth/v1/token/refresh', {
  method: 'POST',
  headers: {
    accept: 'application/json',
    Authorization: 'Bearer <access_token>',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
  "refresh": "<refresh>"
}),
});

console.log(await response.json());

import requests

url = "https://api.antecipafacil.net.br/api/auth/v1/token/refresh"
headers = {
    "accept": "application/json",
    "Authorization": "Bearer <access_token>",
    "content-type": "application/json",
}
payload = {
    "refresh": "<refresh>"
}

response = requests.post(url, headers=headers, json=payload)
response.raise_for_status()
print(response.json())

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://api.antecipafacil.net.br/api/auth/v1/token/refresh");
request.Headers.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", "<access_token>");
request.Content = new StringContent("""{
  "refresh": "<refresh>"
}""", Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

let client = reqwest::Client::new();
let response = client
    .request(reqwest::Method::POST, "https://api.antecipafacil.net.br/api/auth/v1/token/refresh")
    .bearer_auth("<access_token>")
    .header("accept", "application/json")
    .json(&serde_json::json!({
  "refresh": "<refresh>"
}))
    .send()
    .await?;

let body = response.text().await?;
println!("{}", body);

Copiar exemplo