{
  "info": {
    "description": "太阳码生成 / 解析接口（与 /api/docs.md、/api/openapi.json 同源）。\n导入后先把 baseUrl 改成自己的站点，并按需填写 apiKey；\n每个请求都带「请求示例」，右侧还能直接看到各状态码的「保存的响应示例」。",
    "name": "云链智码 API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "item": [
        {
          "name": "生成太阳码（图片 / JSON）",
          "request": {
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
            },
            "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
            "header": [
              {
                "key": "X-API-Key",
                "type": "text",
                "value": "{{apiKey}}"
              },
              {
                "key": "Content-Type",
                "type": "text",
                "value": "application/json"
              }
            ],
            "method": "POST",
            "url": {
              "query": [],
              "raw": "{{baseUrl}}/api/encode"
            }
          },
          "response": [
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"json\",\n  \"version\": 0,\n  \"level\": \"Q\",\n  \"levelIndex\": 2,\n  \"mask\": 14,\n  \"typebits\": 122236,\n  \"mode\": \"ALPHANUMERIC\",\n  \"transformed\": \"5M +*-F/2IH%%Q53E9:/-IP\",\n  \"codewords\": 38,\n  \"ecCodewords\": 18,\n  \"size\": 600,\n  \"svg\": \"\u003csvg width=\\\"600\\\" height=\\\"600\\\" …\u003e（完整 SVG 文本）\",\n  \"pngBase64\": \"iVBORw0KGgoAAAANSUhEUg…（PNG 的 base64，不含 data: 前缀）\"\n}",
              "code": 200,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（图片 / JSON） · 200 生成成功，返回内容由 format 决定（图片 / SVG / JSON），并带 X-WXCode-* 响应头",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
                },
                "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "OK"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"载荷超出一枚葵花码容量（v0..v2 均装不下，请缩短内容）\"\n}",
              "code": 400,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（图片 / JSON） · 400 内容为空 / 超出容量 / 参数非法",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
                },
                "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Bad Request"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"内容包含禁止发布的词语\"\n}",
              "code": 403,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（图片 / JSON） · 403 内容命中黑名单关键词，或 logo / url 指向内网地址",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
                },
                "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Forbidden"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求过于频繁，请稍后再试\"\n}",
              "code": 429,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（图片 / JSON） · 429 单 IP 超过每分钟调用上限，响应带 Retry-After",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
                },
                "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Too Many Requests"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"服务繁忙，请稍后重试\"\n}",
              "code": 503,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（图片 / JSON） · 503 同时编码 / 解析的任务已满，请稍后重试",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}"
                },
                "description": "输入内容生成葵花码。请求体支持 JSON、普通表单或 multipart（multipart 时 logo 可传文件）；\nPNG / JPG / GIF 返回图片二进制，SVG 返回矢量文本，format=json 返回结构体。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"text\": \"https://example.com/\",\n  \"format\": \"png\",\n  \"size\": 600,\n  \"margin\": 0,\n  \"fg\": \"#000000\",\n  \"bg\": \"#ffffff\",\n  \"level\": \"L\",\n  \"version\": \"auto\",\n  \"mask\": -1,\n  \"logo\": \"\",\n  \"logoRatio\": 1,\n  \"badge\": \"default\",\n  \"style\": \"classic\",\n  \"color\": \"solid\",\n  \"ghost\": 6\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Service Unavailable"
            }
          ]
        },
        {
          "name": "生成太阳码（query，可直接放进 img）",
          "request": {
            "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
            "header": [
              {
                "key": "X-API-Key",
                "type": "text",
                "value": "{{apiKey}}"
              }
            ],
            "method": "GET",
            "url": {
              "query": [
                {
                  "key": "text",
                  "value": "https://example.com/"
                },
                {
                  "key": "format",
                  "value": "png"
                },
                {
                  "key": "size",
                  "value": "600"
                },
                {
                  "key": "margin",
                  "value": "0"
                },
                {
                  "key": "fg",
                  "value": "#000000"
                },
                {
                  "key": "bg",
                  "value": "#ffffff"
                },
                {
                  "key": "level",
                  "value": "L"
                },
                {
                  "key": "version",
                  "value": "auto"
                },
                {
                  "key": "mask",
                  "value": "-1"
                },
                {
                  "key": "logoRatio",
                  "value": "1"
                },
                {
                  "key": "badge",
                  "value": "default"
                },
                {
                  "key": "style",
                  "value": "classic"
                },
                {
                  "key": "color",
                  "value": "solid"
                },
                {
                  "key": "ghost",
                  "value": "6"
                }
              ],
              "raw": "{{baseUrl}}/api/encode"
            }
          },
          "response": [
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"text\": \"https://example.com/\",\n  \"format\": \"json\",\n  \"version\": 0,\n  \"level\": \"Q\",\n  \"levelIndex\": 2,\n  \"mask\": 14,\n  \"typebits\": 122236,\n  \"mode\": \"ALPHANUMERIC\",\n  \"transformed\": \"5M +*-F/2IH%%Q53E9:/-IP\",\n  \"codewords\": 38,\n  \"ecCodewords\": 18,\n  \"size\": 600,\n  \"svg\": \"\u003csvg width=\\\"600\\\" height=\\\"600\\\" …\u003e（完整 SVG 文本）\",\n  \"pngBase64\": \"iVBORw0KGgoAAAANSUhEUg…（PNG 的 base64，不含 data: 前缀）\"\n}",
              "code": 200,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（query，可直接放进 img） · 200 生成成功，返回内容由 format 决定（图片 / SVG / JSON），并带 X-WXCode-* 响应头",
              "originalRequest": {
                "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "GET",
                "url": {
                  "query": [
                    {
                      "key": "text",
                      "value": "https://example.com/"
                    },
                    {
                      "key": "format",
                      "value": "png"
                    },
                    {
                      "key": "size",
                      "value": "600"
                    },
                    {
                      "key": "margin",
                      "value": "0"
                    },
                    {
                      "key": "fg",
                      "value": "#000000"
                    },
                    {
                      "key": "bg",
                      "value": "#ffffff"
                    },
                    {
                      "key": "level",
                      "value": "L"
                    },
                    {
                      "key": "version",
                      "value": "auto"
                    },
                    {
                      "key": "mask",
                      "value": "-1"
                    },
                    {
                      "key": "logoRatio",
                      "value": "1"
                    },
                    {
                      "key": "badge",
                      "value": "default"
                    },
                    {
                      "key": "style",
                      "value": "classic"
                    },
                    {
                      "key": "color",
                      "value": "solid"
                    },
                    {
                      "key": "ghost",
                      "value": "6"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "OK"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"载荷超出一枚葵花码容量（v0..v2 均装不下，请缩短内容）\"\n}",
              "code": 400,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（query，可直接放进 img） · 400 内容为空 / 超出容量 / 参数非法",
              "originalRequest": {
                "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "GET",
                "url": {
                  "query": [
                    {
                      "key": "text",
                      "value": "https://example.com/"
                    },
                    {
                      "key": "format",
                      "value": "png"
                    },
                    {
                      "key": "size",
                      "value": "600"
                    },
                    {
                      "key": "margin",
                      "value": "0"
                    },
                    {
                      "key": "fg",
                      "value": "#000000"
                    },
                    {
                      "key": "bg",
                      "value": "#ffffff"
                    },
                    {
                      "key": "level",
                      "value": "L"
                    },
                    {
                      "key": "version",
                      "value": "auto"
                    },
                    {
                      "key": "mask",
                      "value": "-1"
                    },
                    {
                      "key": "logoRatio",
                      "value": "1"
                    },
                    {
                      "key": "badge",
                      "value": "default"
                    },
                    {
                      "key": "style",
                      "value": "classic"
                    },
                    {
                      "key": "color",
                      "value": "solid"
                    },
                    {
                      "key": "ghost",
                      "value": "6"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Bad Request"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"内容包含禁止发布的词语\"\n}",
              "code": 403,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（query，可直接放进 img） · 403 内容命中黑名单关键词，或 logo / url 指向内网地址",
              "originalRequest": {
                "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "GET",
                "url": {
                  "query": [
                    {
                      "key": "text",
                      "value": "https://example.com/"
                    },
                    {
                      "key": "format",
                      "value": "png"
                    },
                    {
                      "key": "size",
                      "value": "600"
                    },
                    {
                      "key": "margin",
                      "value": "0"
                    },
                    {
                      "key": "fg",
                      "value": "#000000"
                    },
                    {
                      "key": "bg",
                      "value": "#ffffff"
                    },
                    {
                      "key": "level",
                      "value": "L"
                    },
                    {
                      "key": "version",
                      "value": "auto"
                    },
                    {
                      "key": "mask",
                      "value": "-1"
                    },
                    {
                      "key": "logoRatio",
                      "value": "1"
                    },
                    {
                      "key": "badge",
                      "value": "default"
                    },
                    {
                      "key": "style",
                      "value": "classic"
                    },
                    {
                      "key": "color",
                      "value": "solid"
                    },
                    {
                      "key": "ghost",
                      "value": "6"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Forbidden"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求过于频繁，请稍后再试\"\n}",
              "code": 429,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（query，可直接放进 img） · 429 单 IP 超过每分钟调用上限，响应带 Retry-After",
              "originalRequest": {
                "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "GET",
                "url": {
                  "query": [
                    {
                      "key": "text",
                      "value": "https://example.com/"
                    },
                    {
                      "key": "format",
                      "value": "png"
                    },
                    {
                      "key": "size",
                      "value": "600"
                    },
                    {
                      "key": "margin",
                      "value": "0"
                    },
                    {
                      "key": "fg",
                      "value": "#000000"
                    },
                    {
                      "key": "bg",
                      "value": "#ffffff"
                    },
                    {
                      "key": "level",
                      "value": "L"
                    },
                    {
                      "key": "version",
                      "value": "auto"
                    },
                    {
                      "key": "mask",
                      "value": "-1"
                    },
                    {
                      "key": "logoRatio",
                      "value": "1"
                    },
                    {
                      "key": "badge",
                      "value": "default"
                    },
                    {
                      "key": "style",
                      "value": "classic"
                    },
                    {
                      "key": "color",
                      "value": "solid"
                    },
                    {
                      "key": "ghost",
                      "value": "6"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Too Many Requests"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"服务繁忙，请稍后重试\"\n}",
              "code": 503,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "生成太阳码（query，可直接放进 img） · 503 同时编码 / 解析的任务已满，请稍后重试",
              "originalRequest": {
                "description": "与 POST /api/encode 能力完全一致，只是参数放在 query 里，适合 \u003cimg src=\"...\"\u003e。\n二进制响应同样带 X-WXCode-* 头。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：none\n\n请求示例：\n{{baseUrl}}/api/encode?text=https%3A%2F%2Fexample.com%2F\u0026format=png\u0026size=400",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "GET",
                "url": {
                  "query": [
                    {
                      "key": "text",
                      "value": "https://example.com/"
                    },
                    {
                      "key": "format",
                      "value": "png"
                    },
                    {
                      "key": "size",
                      "value": "600"
                    },
                    {
                      "key": "margin",
                      "value": "0"
                    },
                    {
                      "key": "fg",
                      "value": "#000000"
                    },
                    {
                      "key": "bg",
                      "value": "#ffffff"
                    },
                    {
                      "key": "level",
                      "value": "L"
                    },
                    {
                      "key": "version",
                      "value": "auto"
                    },
                    {
                      "key": "mask",
                      "value": "-1"
                    },
                    {
                      "key": "logoRatio",
                      "value": "1"
                    },
                    {
                      "key": "badge",
                      "value": "default"
                    },
                    {
                      "key": "style",
                      "value": "classic"
                    },
                    {
                      "key": "color",
                      "value": "solid"
                    },
                    {
                      "key": "ghost",
                      "value": "6"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/encode"
                }
              },
              "status": "Service Unavailable"
            }
          ]
        },
        {
          "name": "批量生成太阳码",
          "request": {
            "body": {
              "mode": "raw",
              "options": {
                "raw": {
                  "language": "json"
                }
              },
              "raw": "{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}"
            },
            "description": "一次最多 50 条，逐条独立、逐条计费。顶层参数作用于全部条目，items[].text 为每条内容，\nitems 里也可以用 format / size / margin / fg / bg / logo / logoRatio / badge / style / color / ghost 覆盖顶层值。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}",
            "header": [
              {
                "key": "X-API-Key",
                "type": "text",
                "value": "{{apiKey}}"
              },
              {
                "key": "Content-Type",
                "type": "text",
                "value": "application/json"
              }
            ],
            "method": "POST",
            "url": {
              "query": [],
              "raw": "{{baseUrl}}/api/encode/batch"
            }
          },
          "response": [
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"ok\": 1,\n  \"failed\": 1,\n  \"total\": 2,\n  \"charged\": 1,\n  \"results\": [\n    {\n      \"index\": 0,\n      \"text\": \"https://a.example.com/1\",\n      \"ok\": true,\n      \"version\": 0,\n      \"level\": \"M\",\n      \"mask\": 7,\n      \"mode\": \"ALPHANUMERIC\",\n      \"svg\": \"\u003csvg width=\\\"300\\\" height=\\\"300\\\" …\u003e\",\n      \"pngBase64\": \"iVBORw0KGgoAAAANSUhEUg…\",\n      \"bytes\": 32313,\n      \"ms\": 19\n    },\n    {\n      \"index\": 1,\n      \"text\": \"https://b.example.com/2\",\n      \"ok\": false,\n      \"error\": \"内容过长（上限 8192 字节）\"\n    }\n  ]\n}",
              "code": 200,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "批量生成太阳码 · 200 逐条结果：整体仍是 200，单条成败看 results[].ok",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}"
                },
                "description": "一次最多 50 条，逐条独立、逐条计费。顶层参数作用于全部条目，items[].text 为每条内容，\nitems 里也可以用 format / size / margin / fg / bg / logo / logoRatio / badge / style / color / ghost 覆盖顶层值。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode/batch"
                }
              },
              "status": "OK"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"items 不能为空\"\n}",
              "code": 400,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "批量生成太阳码 · 400 items 为空 / 超过 50 条 / JSON 不合法",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}"
                },
                "description": "一次最多 50 条，逐条独立、逐条计费。顶层参数作用于全部条目，items[].text 为每条内容，\nitems 里也可以用 format / size / margin / fg / bg / logo / logoRatio / badge / style / color / ghost 覆盖顶层值。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode/batch"
                }
              },
              "status": "Bad Request"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求体超过大小上限\"\n}",
              "code": 413,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "批量生成太阳码 · 413 请求体超过 4MB 上限",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}"
                },
                "description": "一次最多 50 条，逐条独立、逐条计费。顶层参数作用于全部条目，items[].text 为每条内容，\nitems 里也可以用 format / size / margin / fg / bg / logo / logoRatio / badge / style / color / ghost 覆盖顶层值。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode/batch"
                }
              },
              "status": "Request Entity Too Large"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求过于频繁，请稍后再试\"\n}",
              "code": 429,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "批量生成太阳码 · 429 超过每分钟调用上限",
              "originalRequest": {
                "body": {
                  "mode": "raw",
                  "options": {
                    "raw": {
                      "language": "json"
                    }
                  },
                  "raw": "{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}"
                },
                "description": "一次最多 50 条，逐条独立、逐条计费。顶层参数作用于全部条目，items[].text 为每条内容，\nitems 里也可以用 format / size / margin / fg / bg / logo / logoRatio / badge / style / color / ghost 覆盖顶层值。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json\n\n请求示例（application/json）：\n{\n  \"format\": \"json\",\n  \"size\": 300,\n  \"margin\": 0,\n  \"items\": [\n    {\n      \"text\": \"https://a.example.com/1\"\n    },\n    {\n      \"text\": \"https://b.example.com/2\"\n    }\n  ]\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  },
                  {
                    "key": "Content-Type",
                    "type": "text",
                    "value": "application/json"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/encode/batch"
                }
              },
              "status": "Too Many Requests"
            }
          ]
        }
      ],
      "name": "生成"
    },
    {
      "item": [
        {
          "name": "解析太阳码 / 自动识别",
          "request": {
            "body": {
              "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
              "formdata": [
                {
                  "description": "图片文件字段，也接受 image / logo / icon",
                  "key": "file",
                  "src": [],
                  "type": "file"
                }
              ],
              "mode": "formdata"
            },
            "description": "上传图片解析太阳码。三种投喂方式任选其一：multipart 字段 file（也接受 image）、原始图片字节、\nJSON 的 image / url。加 family=auto 时先试太阳码再试普通二维码，prefer=qr 可让二维码优先。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
            "header": [
              {
                "key": "X-API-Key",
                "type": "text",
                "value": "{{apiKey}}"
              }
            ],
            "method": "POST",
            "url": {
              "query": [
                {
                  "key": "family",
                  "value": "auto"
                },
                {
                  "key": "prefer",
                  "value": "qr"
                }
              ],
              "raw": "{{baseUrl}}/api/decode"
            }
          },
          "response": [
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"family\": \"WX_CODE\",\n  \"version\": 0,\n  \"ecLevel\": \"Q\",\n  \"mask\": 14,\n  \"typebits\": 122236,\n  \"mode\": \"ALPHANUMERIC\",\n  \"count\": 23,\n  \"qrText\": \"5M +*-F/2IH%%Q53E9:/-IP\",\n  \"payload\": \"https://example.com/\",\n  \"corrections\": 0,\n  \"box\": {\n    \"x\": 0.499,\n    \"y\": 0.499,\n    \"rx\": 0.507,\n    \"ry\": 0.507\n  }\n}",
              "code": 200,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析太阳码 / 自动识别 · 200 识别成功：family 区分码型，payload 是最终内容",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "图片文件字段，也接受 image / logo / icon",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "上传图片解析太阳码。三种投喂方式任选其一：multipart 字段 file（也接受 image）、原始图片字节、\nJSON 的 image / url。加 family=auto 时先试太阳码再试普通二维码，prefer=qr 可让二维码优先。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [
                    {
                      "key": "family",
                      "value": "auto"
                    },
                    {
                      "key": "prefer",
                      "value": "qr"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/decode"
                }
              },
              "status": "OK"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"未找到葵花码的 3 组定位图案\"\n}",
              "code": 400,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析太阳码 / 自动识别 · 400 没识别到码 / 图片不合法 / 缺字段（family=auto 时错误文案会以「未识别到太阳码或普通二维码」开头）",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "图片文件字段，也接受 image / logo / icon",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "上传图片解析太阳码。三种投喂方式任选其一：multipart 字段 file（也接受 image）、原始图片字节、\nJSON 的 image / url。加 family=auto 时先试太阳码再试普通二维码，prefer=qr 可让二维码优先。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [
                    {
                      "key": "family",
                      "value": "auto"
                    },
                    {
                      "key": "prefer",
                      "value": "qr"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/decode"
                }
              },
              "status": "Bad Request"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"拒绝访问内网 / 回环地址\"\n}",
              "code": 403,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析太阳码 / 自动识别 · 403 图片地址指向内网 / 回环地址",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "图片文件字段，也接受 image / logo / icon",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "上传图片解析太阳码。三种投喂方式任选其一：multipart 字段 file（也接受 image）、原始图片字节、\nJSON 的 image / url。加 family=auto 时先试太阳码再试普通二维码，prefer=qr 可让二维码优先。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [
                    {
                      "key": "family",
                      "value": "auto"
                    },
                    {
                      "key": "prefer",
                      "value": "qr"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/decode"
                }
              },
              "status": "Forbidden"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求过于频繁，请稍后再试\"\n}",
              "code": 429,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析太阳码 / 自动识别 · 429 超过每分钟调用上限",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "图片文件字段，也接受 image / logo / icon",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "上传图片解析太阳码。三种投喂方式任选其一：multipart 字段 file（也接受 image）、原始图片字节、\nJSON 的 image / url。加 family=auto 时先试太阳码再试普通二维码，prefer=qr 可让二维码优先。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [
                    {
                      "key": "family",
                      "value": "auto"
                    },
                    {
                      "key": "prefer",
                      "value": "qr"
                    }
                  ],
                  "raw": "{{baseUrl}}/api/decode"
                }
              },
              "status": "Too Many Requests"
            }
          ]
        },
        {
          "name": "解析普通二维码（好友码）",
          "request": {
            "body": {
              "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
              "formdata": [
                {
                  "description": "二维码图片文件（也接受 image）",
                  "key": "file",
                  "src": [],
                  "type": "file"
                }
              ],
              "mode": "formdata"
            },
            "description": "读取普通 QR。微信「加好友」名片会解出 https://u.wechat.com/... 这类链接，\nurl 字段可直接丢给 /api/encode 再生成太阳码。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
            "header": [
              {
                "key": "X-API-Key",
                "type": "text",
                "value": "{{apiKey}}"
              }
            ],
            "method": "POST",
            "url": {
              "query": [],
              "raw": "{{baseUrl}}/api/qr"
            }
          },
          "response": [
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"text\": \"https://u.wechat.com/xxxxxxxxxxxx\",\n  \"url\": \"https://u.wechat.com/xxxxxxxxxxxx\",\n  \"version\": 4,\n  \"ecLevel\": \"M\",\n  \"mask\": 3,\n  \"mode\": \"BYTE\",\n  \"modules\": 33,\n  \"corrections\": 0\n}",
              "code": 200,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析普通二维码（好友码） · 200 识别成功，返回二维码文本与其中的链接",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "二维码图片文件（也接受 image）",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "读取普通 QR。微信「加好友」名片会解出 https://u.wechat.com/... 这类链接，\nurl 字段可直接丢给 /api/encode 再生成太阳码。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/qr"
                }
              },
              "status": "OK"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"没找到二维码的定位图案\"\n}",
              "code": 400,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析普通二维码（好友码） · 400 没找到定位图案 / 校验失败 / 图片不合法",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "二维码图片文件（也接受 image）",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "读取普通 QR。微信「加好友」名片会解出 https://u.wechat.com/... 这类链接，\nurl 字段可直接丢给 /api/encode 再生成太阳码。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/qr"
                }
              },
              "status": "Bad Request"
            },
            {
              "_postman_previewlanguage": "json",
              "body": "{\n  \"error\": \"请求过于频繁，请稍后再试\"\n}",
              "code": 429,
              "cookie": [],
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json; charset=utf-8"
                }
              ],
              "name": "解析普通二维码（好友码） · 429 超过每分钟调用上限",
              "originalRequest": {
                "body": {
                  "description": "multipart 上传图片；也支持原始图片字节（Content-Type: image/*），或 JSON 的 {\"image\":\"data:image/png;base64,...\"} / {\"url\":\"https://...\"}",
                  "formdata": [
                    {
                      "description": "二维码图片文件（也接受 image）",
                      "key": "file",
                      "src": [],
                      "type": "file"
                    }
                  ],
                  "mode": "formdata"
                },
                "description": "读取普通 QR。微信「加好友」名片会解出 https://u.wechat.com/... 这类链接，\nurl 字段可直接丢给 /api/encode 再生成太阳码。\n\n鉴权：可选 API Key / 会话 Cookie\nContent-Type：json+multipart+binary\n\n请求示例（application/json）：\n{\n  \"image\": \"data:image/png;base64,iVBORw0KGgo…\"\n}",
                "header": [
                  {
                    "key": "X-API-Key",
                    "type": "text",
                    "value": "{{apiKey}}"
                  }
                ],
                "method": "POST",
                "url": {
                  "query": [],
                  "raw": "{{baseUrl}}/api/qr"
                }
              },
              "status": "Too Many Requests"
            }
          ]
        }
      ],
      "name": "解析"
    }
  ],
  "variable": [
    {
      "description": "站点地址，例如 https://your.domain",
      "key": "baseUrl",
      "value": "https://khm.lxwowbp.cn"
    },
    {
      "description": "可选。「我的」页面复制的 Key；本站开启「使用需要登录」时必填",
      "key": "apiKey",
      "value": ""
    }
  ]
}