Fetching Cached Values

Retrieve previously stored values from your caches using ductape.cache.values().

Quick Example

TypeScript

const values = await ductape.cache.values({
  cache_tag: 'api-responses',
});

console.log(values);

Java

Map<String, Object> values = ductape.cache.values(Map.of(
  "cache_tag", "api-responses"
));

System.out.println(values);

Go

values := client.cache.values({
  "cache_tag": "api-responses",
});

fmt.Println(values);

.NET

var values = await ductape.cache.values({
  ["cache_tag"] = "api-responses",
});

Console.WriteLine(values);

How It Works

Query cached data by specifying filters like cache tag, component tag, or product tag. This is useful for reusing cached API responses or computed values across your application.

Examples

Fetch all values from a cache

TypeScript

const values = await ductape.cache.values({
  cache_tag: 'user-data',
});

Java

Map<String, Object> values = ductape.cache.values(Map.of(
  "cache_tag", "user-data"
));

Go

values := client.cache.values({
  "cache_tag": "user-data",
});

.NET

var values = await ductape.cache.values({
  ["cache_tag"] = "user-data",
});

Filter by component

TypeScript

const values = await ductape.cache.values({
  cache_tag: 'api-responses',
  component_tag: 'fetch-user',
  component_type: 'action',
});

Java

Map<String, Object> values = ductape.cache.values(Map.of(
  "cache_tag", "api-responses",
  "component_tag", "fetch-user",
  "component_type", "action"
));

Go

values := client.cache.values({
  "cache_tag": "api-responses",
  "component_tag": "fetch-user",
  "component_type": "action",
});

.NET

var values = await ductape.cache.values({
  ["cache_tag"] = "api-responses",
  ["component_tag"] = "fetch-user",
  ["component_type"] = "action",
});

Filter non-expired values only

TypeScript

const values = await ductape.cache.values({
  cache_tag: 'temp-data',
  expiry: new Date()
});

Java

Map<String, Object> values = ductape.cache.values(Map.of(
  "cache_tag", "temp-data",
  expiry: Instant.now()
));

Go

values := client.cache.values({
  "cache_tag": "temp-data",
  expiry: new Date()
});

.NET

var values = await ductape.cache.values({
  ["cache_tag"] = "temp-data",
  expiry: DateTime.UtcNow
});

Response

[
  {
    "key": "user_123_result",
    "value": "{\"score\":88}",
    "cache_tag": "api-responses",
    "component_tag": "score_action",
    "component_type": "action",
    "expiry": "2025-05-01T00:00:00.000Z"
  }
]

Field	Description
key	Unique key for this cached value
value	The cached value (typically stringified JSON)
cache_tag	Cache this value belongs to
product	Product where this value was stored
component_tag	Component that stored the value
component_type	Type of component (action, event, etc.)
expiry	Expiration date, if set

---

Reference

Filter Options

TypeScript

interface FetchRemoteCachePayload {
  cache_tag: string;
  product: string;
  component_tag?: string;
  component_type?: string;
  expiry?: Date;
}

Java

interface FetchRemoteCachePayload Map.of(
  cache_tag: string;
  product: string;
  component_tag?: string;
  component_type?: string;
  expiry?: Date;
)

Go

interface FetchRemoteCachePayload {
  cache_tag: string;
  product: string;
  component_tag?: string;
  component_type?: string;
  expiry?: Date;
}

.NET

interface FetchRemoteCachePayload {
  cache_tag: string;
  product: string;
  component_tag?: string;
  component_type?: string;
  expiry?: Date;
}

See Also

• Caching Overview
• Setting Up Caches