{
  "manifest": {
    "spekkr": 1,
    "id": "vex/idempotency-keys",
    "name": "Idempotent API requests",
    "summary": "Let API clients retry safely: an Idempotency-Key header, stored answers, and exact rules for two requests that arrive at once.",
    "keywords": [
      "retries",
      "duplicate requests",
      "exactly once",
      "payments api",
      "safe retry",
      "dedupe",
      "double charge"
    ],
    "kind": "app part",
    "version": "0.1.2",
    "author": {
      "id": "vex",
      "name": "Vex"
    },
    "targets": {
      "platforms": [
        "backend"
      ]
    },
    "customize": {
      "settings": [
        {
          "key": "key_hours",
          "label": "Hours a key is remembered",
          "default": "24",
          "help": "A whole number."
        }
      ],
      "options": [
        {
          "key": "require_key",
          "label": "Refuse a request without a key",
          "default": false,
          "help": "A POST without the header gets status 400."
        }
      ],
      "swaps": [
        {
          "key": "store",
          "label": "Where keys are kept",
          "choices": [
            "database",
            "redis"
          ],
          "default": "database",
          "help": "The database lets a key be saved in the same transaction as the work."
        }
      ]
    },
    "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 keys are kept in Redis"
      ],
      "permissions": [
        "shell",
        "network"
      ]
    },
    "demo": {
      "screenshots": [
        "shots/desk-ready.png",
        "shots/first-charge.png",
        "shots/replayed-charge.png",
        "shots/reused-key.png"
      ]
    },
    "safety": {
      "secrets": [
        "DATABASE_URL",
        "REDIS_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/idempotency-keys."
      }
    ]
  },
  "links": {
    "page": "./",
    "bundle": "bundle.tar.gz",
    "files": {
      "design.md": "files/design.md",
      "shots/desk-ready.png": "files/shots/desk-ready.png",
      "shots/first-charge.png": "files/shots/first-charge.png",
      "shots/replayed-charge.png": "files/shots/replayed-charge.png",
      "shots/reused-key.png": "files/shots/reused-key.png",
      "spec.md": "files/spec.md",
      "tasks.md": "files/tasks.md"
    }
  },
  "publishedBy": "vex",
  "uploaded": {
    "shots/desk-ready.png": {
      "bytes": 122868,
      "type": "image/png"
    },
    "shots/first-charge.png": {
      "bytes": 142801,
      "type": "image/png"
    },
    "shots/replayed-charge.png": {
      "bytes": 149489,
      "type": "image/png"
    },
    "shots/reused-key.png": {
      "bytes": 142385,
      "type": "image/png"
    }
  }
}
