{
  "name": "CellarTracker Wine API",
  "version": "0.4.0",
  "description": "Read-only API for a private wine collection stored in Cloudflare R2.",
  "base_url": "https://api.wine.freakalis.com",
  "openapi_url": "https://api.wine.freakalis.com/openapi.json",
  "authentication": {
    "type": "api_key",
    "header": "X-API-Key",
    "note": "Most endpoints require a fixed API key. Root, meta, health, and openapi.json are public for discovery."
  },
  "endpoints": [
    {
      "path": "/",
      "purpose": "Compact API index and metadata."
    },
    {
      "path": "/meta",
      "purpose": "Same compact API index and metadata as root."
    },
    {
      "path": "/openapi.json",
      "purpose": "Machine-readable OpenAPI schema for GPT Actions and clients."
    },
    {
      "path": "/health",
      "purpose": "Health check."
    },
    {
      "path": "/index",
      "purpose": "Datasource index from index.json."
    },
    {
      "path": "/drink-now",
      "purpose": "Prioritized wines to drink now."
    },
    {
      "path": "/inventory",
      "purpose": "Current inventory from processed.json."
    },
    {
      "path": "/stats",
      "purpose": "Collection stats from stats.json."
    },
    {
      "path": "/consumed",
      "purpose": "Consumed wine history from consumed.json."
    },
    {
      "path": "/search",
      "purpose": "Unified search across inventory and consumed wines."
    },
    {
      "path": "/recommend",
      "purpose": "Wine recommendations based on food and urgency."
    }
  ],
  "examples": [
    "https://api.wine.freakalis.com/search?q=riesling&source=all&limit=50",
    "https://api.wine.freakalis.com/inventory?country=germany&ready=false&limit=25",
    "https://api.wine.freakalis.com/recommend?food=salmon&limit=5"
  ]
}