Menerima Email: Rute

Refresh Token

Tukar refresh token dengan access token baru dan refresh token baru. Pasangan lama langsung berhenti berfungsi.

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

Rute ini tidak memerlukan header Authorization. Access token berlaku 1 jam dan refresh token berlaku 15 hari.

!

Refresh token hanya bisa dipakai sekali. Simpan token dan refresh_token yang baru sebelum melakukan hal lain, karena pasangan lama langsung mati begitu panggilan ini berhasil.

Parameter body

  • refresh_tokenstringwajib

    Refresh token saat ini (R.S.C.G.…).

Mulai cepat

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);

Respons

{
  "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"
  }
}

Field respons

  • data.token

    Access token baru. Kirim di header Authorization.

  • data.refresh_token

    Refresh token baru. Gunakan sekali, pada refresh berikutnya.

  • data.expires_at

    Kapan access token kedaluwarsa (UTC).

  • data.refresh_expires_at

    Kapan refresh token kedaluwarsa (UTC).

Refresh otomatis

Lakukan refresh saat request gagal dengan TOKEN_EXPIRED, dan pastikan hanya satu refresh yang berjalan pada satu waktu: refresh token hanya bisa dipakai sekali.

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

Jika refresh gagal dengan INVALID_REFRESH_TOKEN, pasangan tersebut tidak bisa dipulihkan. Buat token baru di dashboard.

Error

Error di level HTTP mengembalikan type, code, dan message. Error yang ditandai CMD dikembalikan di dalam hasil perintah, dengan HTTP 200.

  • 401INVALID_REFRESH_TOKEN

    Refresh token tidak valid, kedaluwarsa, dicabut, atau sudah dipakai. Buat token baru di dashboard.

  • 429RATE_LIMITED

    Lebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.

  • 503AUTH_UNAVAILABLE

    Autentikasi sementara tidak tersedia. Coba lagi.