HTTP caching
HTTP caching and conditional requests: ETag / If-None-Match (304), If-Match (412 / 428), Last-Modified / If-Modified-Since, Cache-Control variants and Vary.
Your account unlocks these endpoints. Try it on each endpoint's page sends your key for you; from your own code, send a key from your API keys page in the X-TestingApis-Key header.
These endpoints need a free account. Create one or sign in to see their details and try them here.
- GETHEAD
https://api.testingapis.com/api/cache/etagReturns the versioned document with its ETagReturns the versioned document with its ETag. - PUT
https://api.testingapis.com/api/cache/etagUpdates the document only if the client's ETag is currentUpdates the document only if the client's ETag is current. - POST
https://api.testingapis.com/api/cache/etag/resetResets the ETag document to version 1 and its default contentResets the ETag document to version 1 and its default content. - GETHEAD
https://api.testingapis.com/api/cache/last-modifiedReturns a resource with a fixed Last-Modified dateReturns a resource with a fixed Last-Modified date. - GET
https://api.testingapis.com/api/cache/max-age/{seconds}Returns a response that clients may cache for the given number of secondsReturns a response that clients may cache for the given number of seconds. - GET
https://api.testingapis.com/api/cache/no-storeReturns a response that must never be cachedReturns a response that must never be cached. - GET
https://api.testingapis.com/api/cache/varyReturns a greeting in the language chosen by Accept-LanguageReturns a greeting in the language chosen by Accept-Language.
Example request
Returns the versioned document with its ETag. Full reference and a Send button.
cURL
curl -X GET "https://api.testingapis.com/api/cache/etag" \
-H "X-TestingApis-Key: YOUR_API_KEY"Response · 200 OK
{
"id": 1,
"version": 1,
"title": "TestingAPIs cached document",
"content": "Send If-None-Match to get a 304, and If-Match on PUT to make a conditional update.",
"updatedAt": "2025-01-01T00:00:00Z",
"etag": "\"doc-v1\""
}Sign in to see the details
The parameters, request and response examples and the live Try it panel for these endpoints are for signed-in members. Accounts are free and take a few seconds to create.