Menerima Email: Rute
Refresh Token
Tukar refresh token dengan access token baru dan refresh token baru. Pasangan lama langsung berhenti berfungsi.
https://g.sendcorex.com/v1/token/refreshRute 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_tokenstringwajibRefresh 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.tokenAccess token baru. Kirim di header
Authorization.data.refresh_tokenRefresh token baru. Gunakan sekali, pada refresh berikutnya.
data.expires_atKapan access token kedaluwarsa (UTC).
data.refresh_expires_atKapan 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;
}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.
- 401
INVALID_REFRESH_TOKENRefresh token tidak valid, kedaluwarsa, dicabut, atau sudah dipakai. Buat token baru di dashboard.
- 429
RATE_LIMITEDLebih dari 15 request/detik atau 15 yang sedang diproses untuk IP + kotak surat yang sama. Tunggu sesuai jumlah detik di Retry-After.
- 503
AUTH_UNAVAILABLEAutentikasi sementara tidak tersedia. Coba lagi.