{
  "id": "bbg-p0339-api-gateways-and-contracts-api",
  "title": "API and SDK Usage Boundary",
  "chapter": "api-gateways-and-contracts",
  "batch": "08",
  "rank": 80,
  "sourcePage": 339,
  "sourcePointer": "p. 339",
  "status": "accepted",
  "reviewerStatus": "reviewed",
  "fidelityScore": 0.9,
  "canvas": {
    "width": 960,
    "height": 640
  },
  "fireworksTechGraph": {
    "style": "style-1-flat-icon",
    "diagramType": "comparison",
    "topologyNotes": [
      "source page render inspected",
      "extracted page text inspected",
      "source page render inspected",
      "preserve API versus SDK structure: API defines protocol contract, SDK wraps the API with libraries, examples, tools, and local developer ergonomics",
      "omit source branding, screenshot art, and copied explanatory prose"
    ],
    "publicBoundary": [
      "original vector output",
      "no source pixels",
      "no source mark or long wording"
    ]
  },
  "callouts": [],
  "sourceReview": {
    "conceptAnchors": [
      "concept: API contract",
      "concept: request response",
      "concept: SDK library wrapper",
      "concept: developer tooling"
    ],
    "labelSource": "curated",
    "semanticStatus": "reviewed"
  },
  "groups": [
    {
      "id": "api",
      "label": "API",
      "x": 70,
      "y": 126,
      "w": 360,
      "h": 300
    },
    {
      "id": "sdk",
      "label": "SDK",
      "x": 530,
      "y": 126,
      "w": 360,
      "h": 300
    }
  ],
  "shapes": [
    {
      "id": "client",
      "kind": "actor",
      "label": "Developer app",
      "detail": "calls",
      "x": 112,
      "y": 200,
      "w": 82,
      "h": 88,
      "tone": "blue"
    },
    {
      "id": "contract",
      "kind": "gateway",
      "label": "API",
      "detail": "rules endpoint",
      "x": 250,
      "y": 196,
      "w": 126,
      "h": 82,
      "tone": "orange"
    },
    {
      "id": "service",
      "kind": "rect",
      "label": "Service",
      "detail": "remote system",
      "x": 250,
      "y": 330,
      "w": 126,
      "h": 58,
      "tone": "green"
    },
    {
      "id": "sdk",
      "kind": "rect",
      "label": "SDK package",
      "detail": "client library",
      "x": 578,
      "y": 164,
      "w": 130,
      "h": 58,
      "tone": "purple"
    },
    {
      "id": "helpers",
      "kind": "rect",
      "label": "Helpers docs",
      "detail": "samples tools",
      "x": 734,
      "y": 164,
      "w": 130,
      "h": 58,
      "tone": "gray"
    },
    {
      "id": "wrapped",
      "kind": "gateway",
      "label": "Wrapped API",
      "detail": "fewer calls",
      "x": 654,
      "y": 314,
      "w": 126,
      "h": 82,
      "tone": "teal"
    }
  ],
  "connectors": [
    {
      "from": "client",
      "to": "contract",
      "label": "HTTP",
      "flow": "main"
    },
    {
      "from": "contract",
      "to": "service",
      "label": "contract",
      "flow": "data"
    },
    {
      "from": "sdk",
      "to": "wrapped",
      "label": "wrap",
      "flow": "control"
    },
    {
      "from": "helpers",
      "to": "wrapped",
      "label": "guide",
      "flow": "data",
      "dashed": true
    },
    {
      "from": "wrapped",
      "to": "service",
      "label": "call API",
      "flow": "main"
    }
  ]
}