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.

POSThttps://g.sendcorex.com/v1/token/refresh
i

Cette 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_tokenstringobligatoire

    Le 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.token

    Le nouvel access token. Envoyez-le dans le header Authorization.

  • data.refresh_token

    Le nouveau refresh token. Utilisez-le une fois, lors du prochain refresh.

  • data.expires_at

    Date d'expiration de l'access token (UTC).

  • data.refresh_expires_at

    Date 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;
}
i

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.

  • 401INVALID_REFRESH_TOKEN

    Le refresh token est invalide, expiré, révoqué ou déjà utilisé. Générez un nouveau token dans le dashboard.

  • 429RATE_LIMITED

    Plus 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.

  • 503AUTH_UNAVAILABLE

    L'authentification est temporairement indisponible. Réessayez.