{
  "id": "api-design-controls",
  "chapter": "api-gateways-and-contracts",
  "batch": "01",
  "rank": 9,
  "sourcePage": 270,
  "sourcePointer": "p. 270",
  "status": "accepted",
  "reviewerStatus": "reviewed",
  "fidelityScore": 0.9,
  "canvas": {
    "width": 960,
    "height": 640
  },
  "fireworksTechGraph": {
    "style": "style-1-flat-icon",
    "diagramType": "architecture",
    "topologyNotes": [
      "source page render inspected",
      "extracted page text inspected",
      "semantic redraw",
      "preserve major box and arrow meaning",
      "do not copy original pixels or wording"
    ],
    "publicBoundary": [
      "original vector output",
      "short generic labels only",
      "source renders remain ignored"
    ]
  },
  "callouts": [],
  "sourceReview": {
    "conceptAnchors": [
      "concept: API Gateways and Contracts"
    ],
    "labelSource": "source-summary",
    "semanticStatus": "reviewed"
  },
  "title": "API Design Control Surface",
  "groups": [
    {
      "id": "contract",
      "label": "Contract",
      "x": 58,
      "y": 112,
      "w": 400,
      "h": 360
    },
    {
      "id": "operations",
      "label": "Operations",
      "x": 520,
      "y": 112,
      "w": 360,
      "h": 360
    }
  ],
  "shapes": [
    {
      "id": "resource",
      "kind": "rect",
      "label": "Resource",
      "detail": "names",
      "x": 92,
      "y": 166,
      "w": 122,
      "h": 68,
      "tone": "blue"
    },
    {
      "id": "method",
      "kind": "diamond",
      "label": "Method",
      "detail": "safe intent",
      "x": 286,
      "y": 154,
      "w": 120,
      "h": 92,
      "tone": "orange"
    },
    {
      "id": "schema",
      "kind": "table",
      "label": "Schema",
      "detail": "request response",
      "x": 170,
      "y": 326,
      "w": 160,
      "h": 96,
      "tone": "green"
    },
    {
      "id": "idempotency",
      "kind": "rect",
      "label": "Idempotency",
      "detail": "retry key",
      "x": 548,
      "y": 164,
      "w": 132,
      "h": 70,
      "tone": "purple"
    },
    {
      "id": "limits",
      "kind": "rect",
      "label": "Limits",
      "detail": "quota pages",
      "x": 714,
      "y": 164,
      "w": 120,
      "h": 70,
      "tone": "red"
    },
    {
      "id": "errors",
      "kind": "rect",
      "label": "Errors",
      "detail": "stable shape",
      "x": 628,
      "y": 336,
      "w": 130,
      "h": 70,
      "tone": "gray"
    }
  ],
  "connectors": [
    {
      "from": "resource",
      "to": "method",
      "label": "verb",
      "flow": "main"
    },
    {
      "from": "method",
      "to": "schema",
      "label": "body",
      "flow": "data"
    },
    {
      "from": "schema",
      "to": "idempotency",
      "label": "safe retry",
      "flow": "control"
    },
    {
      "from": "idempotency",
      "to": "limits",
      "label": "protect",
      "flow": "control"
    },
    {
      "from": "limits",
      "to": "errors",
      "label": "fail well",
      "flow": "alt"
    }
  ]
}