QC Cloud Key-Value API

A simple REST API for storing and retrieving key-value pairs in the cloud

TurboWarp Extension

Use this API in your TurboWarp projects with our custom extension

Dart Master Game

Live demo: A dart-throwing game that syncs player scores to the KV store in real time

Dart Master Scoreboard

Live demo: A scoreboard that polls the KV store to display ranked player scores

Base URL

https://kvstore.quincycoders.click

Overview

This API allows you to store key-value pairs organized by topics. Values automatically expire after 24 hours by default.

Note: All values expire after 24 hours (86,400 seconds) by default. Use the POST endpoint to set a custom TTL.

Size Limits

Limit	Value	Notes
Maximum item size	400 KB	DynamoDB limit for combined topic + key + value
Maximum request body	6 MB	Lambda payload limit (POST endpoint)
Maximum URL length	~2,000 chars	Recommended limit for PUT endpoint values
Topic name	2 KB	DynamoDB partition key limit
Key name	1 KB	DynamoDB sort key limit

Tip: For storing large values, use the POST endpoint with a JSON body instead of the PUT endpoint which encodes values in the URL path.

Endpoints

GET /{topic}

List all keys in a topic.

Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace to list keys from

Example Request

curl https://kvstore.quincycoders.click/myTopic

Response

200 Success

{
  "topic": "myTopic",
  "keys": ["key1", "key2", "key3"]
}

Try it

topic

GET /{topic}/{key}

Retrieve a stored value by topic and key.

Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace for the key
`key`	string	The key to retrieve

Example Request

curl https://kvstore.quincycoders.click/myTopic/myKey

Response

200 Success

{
  "value": "Hello, World!"
}

404 Not Found

{
  "error": "Key 'myKey' not found in topic 'myTopic'"
}

Try it

topic key

PUT /{topic}/{key}/{value}

Store a value using URL path parameters. The value is automatically URL-decoded.

Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace for the key
`key`	string	The key to store
`value`	string	The value to store (URL-encoded)

Example Request

curl -X PUT https://kvstore.quincycoders.click/myTopic/myKey/Hello%20World

Response

201 Created

{
  "message": "Value stored successfully",
  "topic": "myTopic",
  "key": "myKey"
}

Try it

topic key value

POST /{topic}

Store a value using a JSON body. Allows setting a custom TTL.

URL Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace for the key

Body Parameters

Parameter	Type	Required	Description
`key`	string	Yes	The key to store
`value`	any	Yes	The value to store
`ttl`	number	No	Time-to-live in seconds (default: 86400)

Example Request

curl -X POST https://kvstore.quincycoders.click/myTopic \
  -H "Content-Type: application/json" \
  -d '{"key": "myKey", "value": "Hello, World!", "ttl": 3600}'

Response

201 Created

{
  "message": "Value stored successfully",
  "topic": "myTopic",
  "key": "myKey"
}

Try it

topic key value ttl (optional, seconds)

DELETE /{topic}/{key}

Delete a stored value.

Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace for the key
`key`	string	The key to delete

Example Request

curl -X DELETE https://kvstore.quincycoders.click/myTopic/myKey

Response

200 Success

{
  "message": "Value deleted successfully",
  "topic": "myTopic",
  "key": "myKey"
}

404 Not Found

{
  "error": "Key 'myKey' not found in topic 'myTopic'"
}

Try it

topic key

DELETE /{topic}

Delete all keys in a topic.

Parameters

Parameter	Type	Description
`topic`	string	The topic/namespace to delete

Example Request

curl -X DELETE https://kvstore.quincycoders.click/myTopic

Response

200 Success

{
  "message": "Topic deleted successfully",
  "topic": "myTopic",
  "deletedCount": 5
}

Try it

topic

Error Responses

Status Code	Description
400	Bad Request - Missing required parameters
404	Not Found - Key does not exist
500	Internal Server Error