{
  "service": "Shared Context Cache API",
  "description": "CDN for agent intelligence \u2014 agents share computed results so others skip recomputation",
  "network_effect": "More agents caching = more cache hits = faster for everyone",
  "version": "1.0.0",
  "endpoints": {
    "GET /api/cache?key=<key>": "Cached Ergebnis abrufen (erhoet hit_count)",
    "GET /api/cache?search=<query>": "Cache nach Keywords durchsuchen (Keys + Tags)",
    "GET /api/cache?stats=true": "Cache-Statistiken: Hits, Misses, Top-Queries, Agents",
    "POST /api/cache": "Neuen Eintrag speichern"
  },
  "post_body": {
    "key": "Eindeutiger Schluessel (z.B. weather_berlin_2026-03-21)",
    "value": "Beliebiges JSON-Objekt mit dem gecachten Ergebnis",
    "ttl_hours": "Time-to-live in Stunden (Standard: 24)",
    "tags": "Liste von Tags fuer die Suche (z.B. ['weather', 'berlin'])",
    "agent_id": "ID des Agents der den Eintrag erstellt"
  },
  "examples": [
    "/api/cache?key=weather_berlin_2026-03-21",
    "/api/cache?search=crypto+price",
    "/api/cache?search=compliance+gdpr",
    "/api/cache?stats=true"
  ],
  "current_entries": 32
}