v1.0.0

Introduction

Cachist is a global cache layer designed for applications that require distributed state synchronization with low latency. We provide sub-millisecond hot-data access with reliable persistence and powerful search capabilities across keys and JSON content.

Authentication

All requests to the Cachist API must include your API Key in the x-api-key header. You can generate and manage your keys in the Panel.

GET https://api.cachist.com/cache?key=:key
x-api-key: your_sk_...

Core Operations

Basic key-value storage with optional aliases and TTL (Time-To-Live).

Key: max 512 charsText: max 10MBJSON: max 1MB

POST https://api.cachist.com/cache { "key": "user:99", "textValue": "Optional plain text", "jsonValue": { "role": "admin" }, "ttl": 3600, "aliases": ["admin_session"] }

Search & Query DSL

Regex Search

Search across keys and aliases using regular expressions. Use includeValues=true (default) to return the actual cached content.

GET https://api.cachist.com/cache/search?regex=user:.*&includeAliases=true&includeValues=true

JSON Query DSL

Advanced structured search for JSON content. Supports operators like eq, contains, gt, lte, and logical nesting.

POST https://api.cachist.com/cache/search-json { "query": [ { "or": [ { "field": "role", "operator": "eq", "value": "admin" }, { "field": "credits", "operator": "gte", "value": 100 } ]} ], "includeValues": true }

Bulk Delete

Remove multiple keys at once matching a regex pattern.

DELETE https://api.cachist.com/cache/search?regex=temp:.*

Cleanup & TTL

Our background maintenance engine automatically invalidates and removes records from both Redis and Postgres once they expire. You don't need to worry about stale data consuming your credits.

Note: Inactive keys or keys with zero credits will be automatically suspended until credits are refilled.