Receber e-mails: Rotas
Refresh Token
Troque um refresh token por um novo access token e um novo refresh token. O par antigo para de funcionar na hora.
https://g.sendcorex.com/v1/token/refreshEsta rota não precisa do header Authorization. O access token dura 1 hora e o refresh token dura 15 dias.
O refresh token é de uso único. Salve o novo token e o refresh_token antes de qualquer outra coisa, porque o par antigo morre assim que esta chamada dá certo.
Parâmetros do body
refresh_tokenstringobrigatórioO refresh token atual (
R.S.C.G.…).
Início rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/token/refresh',
{
refresh_token: "R.S.C.G.xxxxxxxx"
},
);
console.log(response.data);Resposta
{
"type": "SUCCESS",
"data": {
"token": "S.C.G.xxxxxxxx",
"refresh_token": "R.S.C.G.xxxxxxxx",
"expires_at": "2026-10-10T09:33:00Z",
"refresh_expires_at": "2026-10-25T08:33:00Z"
}
}Campos da resposta
data.tokenO novo access token. Envie-o no header
Authorization.data.refresh_tokenO novo refresh token. Use-o uma vez, no próximo refresh.
data.expires_atQuando o access token expira (UTC).
data.refresh_expires_atQuando o refresh token expira (UTC).
Refresh automático
Faça o refresh quando uma requisição falhar com TOKEN_EXPIRED e garanta que só um refresh rode por vez: o refresh token só pode ser usado uma vez.
Node.js
import axios from 'axios';
const api = axios.create({
baseURL: 'https://g.sendcorex.com',
validateStatus: () => true, // handle 4xx/5xx ourselves
});
let token = process.env.SENDCOREX_TOKEN;
let refreshToken = process.env.SENDCOREX_REFRESH_TOKEN;
async function refresh() {
const res = await api.post('/v1/token/refresh', { refresh_token: refreshToken });
if (res.status !== 200) throw new Error('refresh failed: ' + res.data?.code);
token = res.data.data.token;
refreshToken = res.data.data.refresh_token;
// Persist both values (database / secret store): the old refresh token is dead.
return res.data.data;
}
// One refresh at a time, because the refresh token is single-use.
let refreshing = null;
export async function callWithRefresh(commands) {
const send = () => api.post('/v1', { commands }, { headers: { Authorization: token } });
let res = await send();
if (res.status === 401 && res.data?.code === 'TOKEN_EXPIRED') {
refreshing ??= refresh().finally(() => (refreshing = null));
await refreshing;
res = await send();
}
if (res.status !== 200) throw new Error(res.data?.code ?? 'HTTP ' + res.status);
return res.data.results;
}Se o refresh falhar com INVALID_REFRESH_TOKEN, o par não pode ser recuperado. Gere um novo token no dashboard.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
INVALID_REFRESH_TOKENO refresh token é inválido, expirou, foi revogado ou já foi usado. Gere um novo token no dashboard.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.
- 503
AUTH_UNAVAILABLEA autenticação está temporariamente indisponível. Tente novamente.