{
  "manifest": {
    "spekkr": 1,
    "id": "vex/rate-limiting",
    "name": "Rate limiting",
    "summary": "Limits per API key, user or IP address, with exact arithmetic, standard headers and a table of cases every build must pass.",
    "keywords": [
      "throttle",
      "throttling",
      "429",
      "quota",
      "abuse",
      "api limits"
    ],
    "kind": "app part",
    "version": "0.1.2",
    "author": {
      "id": "vex",
      "name": "Vex"
    },
    "targets": {
      "platforms": [
        "backend"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "default_limit",
          "label": "Requests allowed per window",
          "default": "60",
          "help": "A whole number."
        },
        {
          "key": "default_window_seconds",
          "label": "Length of the window, in seconds",
          "default": "60",
          "help": "A whole number of seconds."
        }
      ],
      "options": [
        {
          "key": "per_route_limits",
          "label": "Different limits for some routes",
          "default": true,
          "help": "A route can name its own limit, such as 5 sign-in attempts in 15 minutes."
        },
        {
          "key": "response_headers",
          "label": "Tell callers what they have left",
          "default": true,
          "help": "Every answer carries the limit, what remains and when it refills."
        }
      ],
      "swaps": [
        {
          "key": "store",
          "label": "Where counts are kept",
          "choices": [
            "redis",
            "database",
            "memory"
          ],
          "default": "redis",
          "help": "Memory only suits an app that runs as one process."
        }
      ]
    },
    "files": [
      {
        "path": "spec.md",
        "about": "Requirements and acceptance criteria."
      },
      {
        "path": "design.md",
        "about": "Data model, rules and flows."
      },
      {
        "path": "tasks.md",
        "about": "Build tasks in order, each with a check."
      }
    ],
    "needs": {
      "accounts": [
        "A Redis server, if counts are kept in Redis"
      ],
      "permissions": [
        "shell",
        "network"
      ]
    },
    "demo": {
      "screenshots": [
        "shots/rate-limit-desk.png",
        "shots/rate-limit-signin.png",
        "shots/rate-limit-cases.png",
        "shots/rate-limit-mobile.png"
      ]
    },
    "safety": {
      "secrets": [
        "REDIS_URL",
        "DATABASE_URL"
      ]
    },
    "lineage": {},
    "changelog": [
      {
        "version": "0.1.2",
        "date": "2026-11-15",
        "note": "Names what it builds."
      },
      {
        "version": "0.1.1",
        "date": "2026-11-14",
        "note": "Says \"person\" where it said \"buyer\"."
      },
      {
        "version": "0.1.0",
        "date": "2026-11-14",
        "note": "Moved from dwrtz/rate-limiting."
      }
    ]
  },
  "links": {
    "page": "./",
    "bundle": "bundle.tar.gz",
    "files": {
      "design.md": "files/design.md",
      "shots/rate-limit-cases.png": "files/shots/rate-limit-cases.png",
      "shots/rate-limit-desk.png": "files/shots/rate-limit-desk.png",
      "shots/rate-limit-mobile.png": "files/shots/rate-limit-mobile.png",
      "shots/rate-limit-signin.png": "files/shots/rate-limit-signin.png",
      "spec.md": "files/spec.md",
      "tasks.md": "files/tasks.md"
    }
  },
  "publishedBy": "vex",
  "uploaded": {
    "shots/rate-limit-cases.png": {
      "bytes": 41053,
      "type": "image/png"
    },
    "shots/rate-limit-desk.png": {
      "bytes": 148012,
      "type": "image/png"
    },
    "shots/rate-limit-mobile.png": {
      "bytes": 157327,
      "type": "image/png"
    },
    "shots/rate-limit-signin.png": {
      "bytes": 69895,
      "type": "image/png"
    }
  }
}
