{
  "info": {
    "name": "白洞门店云开放接口调试集合",
    "description": "用于 Postman / Apifox 调试白洞门店云开放接口。导入后先配置 baseUrl、appKey、appSecret 环境变量，正式接入请在服务端生成签名。",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "const method = pm.request.method.toUpperCase();",
          "const path = pm.request.url.getPath();",
          "const timestamp = Date.now().toString();",
          "const appKey = pm.environment.get('appKey');",
          "const appSecret = pm.environment.get('appSecret');",
          "const signingKey = CryptoJS.SHA256(appSecret).toString();",
          "const payload = [method, path, timestamp].join('\\n');",
          "const signature = CryptoJS.HmacSHA256(payload, signingKey).toString();",
          "",
          "pm.request.headers.upsert({ key: 'X-WH-App-Key', value: appKey });",
          "pm.request.headers.upsert({ key: 'X-WH-Timestamp', value: timestamp });",
          "pm.request.headers.upsert({ key: 'X-WH-Signature', value: signature });"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://open.whbdvr.com",
      "type": "string"
    },
    {
      "key": "appKey",
      "value": "请填写控制台创建的 appKey",
      "type": "string"
    },
    {
      "key": "appSecret",
      "value": "请填写只展示一次的 appSecret",
      "type": "string"
    },
    {
      "key": "orderNo",
      "value": "请填写要查询的订单号",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "查询门店资料",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/tenant/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "tenant",
            "profile"
          ]
        }
      }
    },
    {
      "name": "查询商品列表",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/products?page=1&pageSize=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "products"
          ],
          "query": [
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "pageSize",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询库存流水",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/stock-records?page=1&pageSize=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "stock-records"
          ],
          "query": [
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "pageSize",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询会员列表",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/members?page=1&pageSize=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "members"
          ],
          "query": [
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "pageSize",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询会员消费记录",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/member-consumes?page=1&pageSize=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "member-consumes"
          ],
          "query": [
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "pageSize",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询订单列表",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/orders?page=1&pageSize=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "orders"
          ],
          "query": [
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "pageSize",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询订单详情",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/orders/{{orderNo}}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "orders",
            "{{orderNo}}"
          ]
        }
      }
    },
    {
      "name": "查询经营概览",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/reports/business-overview",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "reports",
            "business-overview"
          ]
        }
      }
    },
    {
      "name": "查询经营趋势",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/reports/business-trend?startDate=2026-05-01&endDate=2026-05-07",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "reports",
            "business-trend"
          ],
          "query": [
            {
              "key": "startDate",
              "value": "2026-05-01"
            },
            {
              "key": "endDate",
              "value": "2026-05-07"
            }
          ]
        }
      }
    },
    {
      "name": "查询商品销售排行",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/reports/product-sales-ranking?startDate=2026-05-01&endDate=2026-05-07&limit=20",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "reports",
            "product-sales-ranking"
          ],
          "query": [
            {
              "key": "startDate",
              "value": "2026-05-01"
            },
            {
              "key": "endDate",
              "value": "2026-05-07"
            },
            {
              "key": "limit",
              "value": "20"
            }
          ]
        }
      }
    },
    {
      "name": "查询会员增长与复购概览",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/reports/member-growth-retention?startDate=2026-05-01&endDate=2026-05-07",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "reports",
            "member-growth-retention"
          ],
          "query": [
            {
              "key": "startDate",
              "value": "2026-05-01"
            },
            {
              "key": "endDate",
              "value": "2026-05-07"
            }
          ]
        }
      }
    },
    {
      "name": "查询门店经营指标分组汇总",
      "request": {
        "method": "GET",
        "header": [],
        "url": {
          "raw": "{{baseUrl}}/api/external/open-api/reports/business-metric-groups?startDate=2026-05-01&endDate=2026-05-07",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "api",
            "external",
            "open-api",
            "reports",
            "business-metric-groups"
          ],
          "query": [
            {
              "key": "startDate",
              "value": "2026-05-01"
            },
            {
              "key": "endDate",
              "value": "2026-05-07"
            }
          ]
        }
      }
    }
  ]
}