The fast, API fronted, SQL backed temporary data store for Apps and campaigns.
Post your app or campaign data to the Flash Cache API where it'll be stored for up to 30 days.
Limitations
- HTTP payloads are limited to 5000 bytes. Any request larger than this will result in a
400 BadRequestresponse. - You will require an Account and API Key to use the service.
- Your chosen
DataKeymust not contain spaces or illegal characters, it must be URL safe. - Data is stored unencrypted. Flash Cache is not designed for storing personal or sensitive data.
- The
DataKeyis unique to the stored object. While the objects value can be changed, theDataKeycan not be changed.
HTTP Headers
The following HTTP are headers used by Flash Cache. Those identified as Request are required for the call.
Those marked as Response are returned in the HTTP response and should be checked and validated as they
contain information such as success status, record counts, error messages etc.
| Endpoint | Header | Details |
|---|---|---|
| Request | ClientId |
Unique ID for your account issued at sign-up. |
| Request | Authorization |
API Key for your App or campaign. |
| Request | ExpiresUtc |
When the cache item will expire (30 days max). |
| Request | DataKey |
Unique key for the cached item. |
| Response | RequestId |
Unique ID for the API request. |
| Response | DataKey |
The DataKey passed in the original API call. |
| Response | Success |
Shows if the request was a success. |
| Response | ResponseMessage |
Human-readable message giving information about the request. |
| Response | ExpiresUtc |
When the cache item will expire (30 days max). |
| Response | Count |
The number of objects affected. |
Example Use
POST Storing data in Flash Cache
Endpoint
https://api.flashcache.uk/v1/cache/add
Request Headers
ClientId: v1:uid_79aec251cd938b1313d7f74611f2c0d1abf894f1 Authorization: v1:api_c1c9676fc333043a298551158a22ce64a2796d54 DataKey: campaign-qr-56G_new
JSON Body
{
"Campaign":
{
"Name": "QR Code",
"ID": "qr-56G_new",
"Owner": "Natasha"
}
}
Response from Flash Cache
Status Code
201 Created
Response Headers
DataKey: campaign-qr-56G_new RequestId: v1:req_4525725e314ab03c632b2712f61fff5c96207b70 ResponseMessage: Created successfully Success: true ExpiresUtc: 10/04/2026 09:38:52
PUT Updating data in Flash Cache
Endpoint
https://api.flashcache.uk/v1/cache/update
Request Headers
ClientId: v1:uid_79aec251cd938b1313d7f74611f2c0d1abf894f1 Authorization: v1:api_c1c9676fc333043a298551158a22ce64a2796d54 DataKey: campaign-qr-56G_new
JSON Body
{
"Campaign":
{
"Name": "QR Code",
"ID": "qr-56G_new",
"Owner": "Anastasia"
}
}
Response from Flash Cache
Status Code
200 Ok
Response Headers
DataKey: campaign-qr-56G_new RequestId: v1:req_49308e37f40ddb9a02ba97f0489d1c131326a424 ResponseMessage: Updated successfully Success: true ExpiresUtc: 10/04/2026 09:38:52
GET Retrieving data from Flash Cache
Endpoint
https://api.flashcache.uk/v1/cache/get
Request Headers
ClientId: v1:uid_79aec251cd938b1313d7f74611f2c0d1abf894f1 Authorization: v1:api_c1c9676fc333043a298551158a22ce64a2796d54 DataKey: campaign-qr-56G_new
Response from Flash Cache
Status Code
200 Ok
Response Headers
DataKey: campaign-qr-56G_new RequestId: v1:req_d1c172ab04b5c1f394bf743c5b05a205f9e12511 ResponseMessage: Object retrieved successfully Success: true ExpiresUtc: 10/04/2026 09:38:52
JSON Body
{
"Campaign":
{
"Name": "QR Code",
"ID": "qr-56G_new",
"Owner": "Anastasia"
}
}
DELETE Deleting data from Flash Cache
Endpoint
https://api.flashcache.uk/v1/cache/delete
Request Headers
ClientId: v1:uid_79aec251cd938b1313d7f74611f2c0d1abf894f1 Authorization: v1:api_c1c9676fc333043a298551158a22ce64a2796d54 DataKey: campaign-qr-56G_new
Response from Flash Cache
Status Code
200 Ok
Response Headers
DataKey: campaign-qr-56G_new RequestId: v1:req_19bdb44c7ba386ebcda61e254f414ce618bf4727 ResponseMessage: Deleted successfully Success: true