Recibir correos: Rutas
Refresh Token
Cambia un refresh token por un nuevo access token y un nuevo refresh token. El par anterior deja de funcionar de inmediato.
https://g.sendcorex.com/v1/token/refreshEsta ruta no necesita el header Authorization. El access token dura 1 hora y el refresh token dura 15 días.
El refresh token es de un solo uso. Guarda el nuevo token y el refresh_token antes de hacer cualquier otra cosa, porque el par anterior deja de servir en cuanto esta llamada tiene éxito.
Parámetros del body
refresh_tokenstringobligatorioEl refresh token actual (
R.S.C.G.…).
Inicio 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);Respuesta
{
"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 de la respuesta
data.tokenEl nuevo access token. Envíalo en el header
Authorization.data.refresh_tokenEl nuevo refresh token. Úsalo una vez, en el próximo refresh.
data.expires_atCuándo expira el access token (UTC).
data.refresh_expires_atCuándo expira el refresh token (UTC).
Refresh automático
Haz el refresh cuando una solicitud falle con TOKEN_EXPIRED y asegúrate de que solo se ejecute un refresh a la vez: el refresh token solo se puede usar una 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;
}Si el refresh falla con INVALID_REFRESH_TOKEN, el par no se puede recuperar. Genera un nuevo token en el dashboard.
Errores
Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.
- 401
INVALID_REFRESH_TOKENEl refresh token no es válido, expiró, fue revocado o ya se usó. Genera un nuevo token en el dashboard.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- 503
AUTH_UNAVAILABLELa autenticación no está disponible temporalmente. Inténtalo de nuevo.