Spec

Code-Snippets

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

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

$ch = curl_init("https://api.oanor.com/cookie-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/cookie-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Beispiel-Response

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

{
    "data": {
        "name": "Cookie API",
        "notes": "Parsing is lenient (it does not reject malformed input); serializing validates the name, dates and enum attributes, and adds Secure automatically when SameSite=None. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/parse",
                "params": {
                    "mode": "'set' (default) for Set-Cookie, or 'cookie' for a request Cookie header",
                    "cookie": "the Set-Cookie string (or a Cookie header)"
                },
                "returns": "the parsed name, value and attributes (or the cookie list/map)"
            },
            {
                "path": "/v1/serialize",
                "params": {
                    "name": "cookie name (required)",
                    "path": "Path (default /)",
                    "value": "cookie value",
                    "domain": "Domain",
                    "encode": "true to URL-encode the value",
                    "secure": "true to add Secure",
                    "expires": "Expires date",
                    "max_age": "Max-Age in seconds",
                    "priority": "Low | Medium | High",
                    "http_only": "true to add HttpOnly",
                    "same_site": "Strict | Lax | None",
                    "partitioned": "true to add Partitioned"
                },
                "returns": "the Set-Cookie header string"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Parse and build HTTP cookies. The parse endpoint reads a Set-Cookie header into its name, value and structured attributes (Domain, Path, Expires, Max-Age, Secure, HttpOnly, SameSite, Priority, Partitioned) — or, with mode=cookie, splits a request Cookie header (a=1; b=2) into a list and a name→value map. The serialize endpoint builds a correct Set-Cookie string from simple fields, with sensible defaults (Path=/), date and value handling and validation. Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T09:25:04.767Z",
        "request_id": "cc504141-3dd9-40a9-a823-dbaa13d9690b"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}