Spec

Code-Snippets

curl "https://api.oanor.com/cachecontrol-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/cachecontrol-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/cachecontrol-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/cachecontrol-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

Echte Antwort dieses Endpoints, erfasst beim letzten Health-Check.

{
    "data": {
        "name": "Cache-Control API",
        "notes": "Numeric directives are in seconds and must be non-negative integers. no-cache means revalidate before use (not 'do not cache'); no-store means do not store at all. This builds and parses the header string — it does not fetch a URL. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/parse",
                "params": {
                    "header": "a Cache-Control header value (required)"
                },
                "returns": "the structured directives and a cacheability summary"
            },
            {
                "path": "/v1/build",
                "params": {
                    "public": "true for public",
                    "max_age": "seconds",
                    "private": "true (or a quoted field list)",
                    "no_cache": "true (or a quoted field list)",
                    "no_store": "true",
                    "s_maxage": "seconds (shared caches)",
                    "immutable": "true",
                    "max_stale": "seconds",
                    "min_fresh": "seconds",
                    "no_transform": "true",
                    "stale_if_error": "seconds",
                    "must_revalidate": "true",
                    "proxy_revalidate": "true",
                    "stale_while_revalidate": "seconds"
                },
                "returns": "the Cache-Control header string"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Parse and build HTTP Cache-Control headers (RFC 9111). The parse endpoint turns a Cache-Control header into structured directives — public/private, no-store, no-cache, max-age, s-maxage, must-revalidate, immutable, stale-while-revalidate, stale-if-error and the rest — with a quick summary of whether the response is cacheable, must be revalidated, its visibility and its max-age. The build endpoint assembles a correct header from simple fields, validating the numeric (seconds) directives and ordering everything canonically. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T09:25:03.177Z",
        "request_id": "7edd2a7b-8644-4f65-91a7-994cc1a502da"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}