Magic card scanner API

const { ticket } = await fetch("https://api.tcggraph.com/v1/scan/tickets", {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.TCGGRAPH_KEY}` },
}).then((r) => r.json());

const socket = new WebSocket(`wss://api.tcggraph.com/v1/scan?ticket=${ticket}`);

socket.onopen = () => {
  socket.send(
    JSON.stringify({
      type: "config",
      games: ["magic-the-gathering"],
      minConfidence: 0.92,
    }),
  );
  // A JPEG straight off the camera, 1280 px across at quality 70.
  socket.send(camera.latestJpeg());
};

socket.onmessage = (event) => {
  const frame = JSON.parse(event.data);

  for (const match of frame.matches ?? []) {
    // printingResolved: set, number and language are settled. finishResolved:
    // the record has one finish. Either false is a choice for the operator.
    intake.add(match.card, match.printingResolved && match.finishResolved, match.alternatives);
  }

  // Unresolved frames arrive too, and cost nothing.
  for (const miss of frame.unresolved ?? []) showHint(miss.reason);

  // Every frame is answered. One in flight at a time: the next goes now.
  if (frame.type === "match" || frame.type === "unresolved" || frame.type === "error") {
    socket.send(camera.latestJpeg());
  }
};

{
  "requestId": "scan_01K5Z8P4XQJ7YB3M",
  "latencyMs": 41,
  "matches": [
    {
      "confidence": 0.9962,
      "billed": true,
      "box": {
        "x": 0.171,
        "y": 0.064,
        "w": 0.658,
        "h": 0.872
      },
      "corners": [
        {
          "x": 0.183,
          "y": 0.064
        },
        {
          "x": 0.829,
          "y": 0.071
        },
        {
          "x": 0.817,
          "y": 0.936
        },
        {
          "x": 0.171,
          "y": 0.928
        }
      ],
      "distance": 21,
      "printingResolved": true,
      "finishResolved": true,
      "card": {
        "id": "mtg_b0faa7f2-b54",
        "game": "magic-the-gathering",
        "name": "Black Lotus",
        "set": {
          "code": "LEA",
          "name": "Limited Edition Alpha"
        },
        "rarity": "rare",
        "prices": [
          {
            "source": "cardmarket",
            "region": "EU",
            "currency": "EUR",
            "market": 33768.47,
            "trend": 33768.47,
            "avg7": 24192.86
          }
        ]
      },
      "alternatives": []
    }
  ],
  "scans": {
    "billed": 1,
    "remaining": 5842
  }
}