Refreshing Session Tokens

Extend session validity by refreshing tokens using ductape.sessions.refresh().

Quick Example

TypeScript

const newTokens = await ductape.sessions.refresh({
  tag: 'user-session',
  refreshToken: 'your-refresh-token',
});

console.log(newTokens.token);        // New session token
console.log(newTokens.refreshToken); // New refresh token

Java

Map<String, Object> newTokens = ductape.sessions.refresh(Map.of(
  "tag", "user-session",
  "refreshToken", "your-refresh-token"
));

System.out.println(newTokens.token);        // New session token
System.out.println(newTokens.refreshToken); // New refresh token

Go

newTokens := client.sessions.refresh({
  "tag": "user-session",
  "refreshToken": "your-refresh-token",
});

fmt.Println(newTokens.token);        // New session token
fmt.Println(newTokens.refreshToken); // New refresh token

.NET

var newTokens = await ductape.sessions.refresh({
  ["tag"] = "user-session",
  ["refreshToken"] = "your-refresh-token",
});

Console.WriteLine(newTokens.token);        // New session token
Console.WriteLine(newTokens.refreshToken); // New refresh token

How It Works

Use the refresh token (received when creating or refreshing a session) to get new tokens without requiring the user to re-authenticate.

Examples

Basic refresh

TypeScript

const result = await ductape.sessions.refresh({
  tag: 'checkout-session',
  refreshToken: 'eueywuwjwmwmw:zyx456cba321...'
});

// Store the new tokens
const { token, refreshToken } = result;

Java

Map<String, Object> result = ductape.sessions.refresh(Map.of(
  "tag", "checkout-session",
  "refreshToken", "eueywuwjwmwmw:zyx456cba321..."
));

// Store the new tokens
Map<String, Object> Map.of( token, refreshToken ) = result;

Go

result := client.sessions.refresh({
  "tag": "checkout-session",
  "refreshToken": "eueywuwjwmwmw:zyx456cba321..."
});

// Store the new tokens
const { token, refreshToken } = result;

.NET

var result = await ductape.sessions.refresh({
  ["tag"] = "checkout-session",
  ["refreshToken"] = "eueywuwjwmwmw:zyx456cba321..."
});

// Store the new tokens
var { token, refreshToken } = result;

Auto-refresh in frontend

TypeScript

async function refreshAuth() {
  const storedRefreshToken = localStorage.getItem('refreshToken');

  const result = await ductape.sessions.refresh({
    tag: 'user-session',
    refreshToken: storedRefreshToken
  });

  localStorage.setItem('token', result.token);
  localStorage.setItem('refreshToken', result.refreshToken);

  return result.token;
}

Java

async function refreshAuth() Map.of(
  Map<String, Object> storedRefreshToken = localStorage.getItem('refreshToken');

  Map<String, Object> result = ductape.sessions.refresh(Map.of(
    "tag", "user-session",
    refreshToken: storedRefreshToken
  ));

  localStorage.setItem('token', result.token);
  localStorage.setItem('refreshToken', result.refreshToken);

  return result.token;
)

Go

async function refreshAuth() {
  storedRefreshToken := localStorage.getItem('refreshToken');

  result := client.sessions.refresh({
    "tag": "user-session",
    refreshToken: storedRefreshToken
  });

  localStorage.setItem('token', result.token);
  localStorage.setItem('refreshToken', result.refreshToken);

  return result.token;
}

.NET

async function refreshAuth() {
  var storedRefreshToken = localStorage.getItem('refreshToken');

  var result = await ductape.sessions.refresh({
    ["tag"] = "user-session",
    refreshToken: storedRefreshToken
  });

  localStorage.setItem('token', result.token);
  localStorage.setItem('refreshToken', result.refreshToken);

  return result.token;
}

Response

{
  "token": "new-session-token...",
  "refreshToken": "new-refresh-token..."
}

Field	Description
token	New session token for subsequent requests
refreshToken	New refresh token for the next refresh

---

Reference

Input

TypeScript

interface RefreshSessionInput {
  product: string;      // Product tag
  env: string;          // Environment (dev, staging, prd)
  tag: string;          // Session tag
  refreshToken: string; // Refresh token from previous session
}

Java

interface RefreshSessionInput Map.of(
  product: string;      // Product tag
  env: string;          // Environment (dev, staging, prd)
  tag: string;          // Session tag
  refreshToken: string; // Refresh token from previous session
)

Go

interface RefreshSessionInput {
  product: string;      // Product tag
  env: string;          // Environment (dev, staging, prd)
  tag: string;          // Session tag
  refreshToken: string; // Refresh token from previous session
}

.NET

interface RefreshSessionInput {
  product: string;      // Product tag
  env: string;          // Environment (dev, staging, prd)
  tag: string;          // Session tag
  refreshToken: string; // Refresh token from previous session
}

See Also

• Generating Sessions
• Decrypting Sessions
• Sessions Overview