Recevoir des e-mails : Routes
Refresh Token
Échangez un refresh token contre un nouvel access token et un nouveau refresh token. L'ancienne paire cesse de fonctionner immédiatement.
https://g.sendcorex.com/v1/token/refreshCette route ne nécessite pas de header Authorization. L'access token est valable 1 heure et le refresh token 15 jours.
Le refresh token est à usage unique. Enregistrez le nouveau token et le refresh_token avant toute autre chose, car l'ancienne paire est invalide dès que cet appel réussit.
Paramètres du body
refresh_tokenstringobligatoireLe refresh token actuel (
R.S.C.G.…).
Démarrage rapide
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);Réponse
{
"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"
}
}Champs de la réponse
data.tokenLe nouvel access token. Envoyez-le dans le header
Authorization.data.refresh_tokenLe nouveau refresh token. Utilisez-le une fois, lors du prochain refresh.
data.expires_atDate d'expiration de l'access token (UTC).
data.refresh_expires_atDate d'expiration du refresh token (UTC).
Refresh automatique
Faites un refresh quand une requête échoue avec TOKEN_EXPIRED, et assurez-vous qu'un seul refresh s'exécute à la fois : le refresh token ne peut être utilisé qu'une fois.
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 le refresh échoue avec INVALID_REFRESH_TOKEN, la paire ne peut pas être récupérée. Générez un nouveau token dans le dashboard.
Erreurs
Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.
- 401
INVALID_REFRESH_TOKENLe refresh token est invalide, expiré, révoqué ou déjà utilisé. Générez un nouveau token dans le dashboard.
- 429
RATE_LIMITEDPlus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.
- 503
AUTH_UNAVAILABLEL'authentification est temporairement indisponible. Réessayez.