API接口文档

cb-api-key: {your_api_key}

GET /api/v1/qrcode/{id}
cb-api-key: xxxxxxxxxx

{
  "success": true,
  "data": {
    "id": "687efd6372eaa51df94bc232",
    "name": "产品宣传二维码",
    "qrType": "URL",
    "targetUrl": "https://example.com/promo",
    "qrImage": "https://cdn.example.com/qrcodes/qr_123.png",
    "createdAt": "2025-07-22T03:09:31.000Z",
  }
}

{
  "error": "QR code not found or access denied"
}

GET /api/v1/qrcode/{id}/stats
cb-api-key: xxxxxxxxxx

{
  "success": true,
  "data": {
    "id": "687efd6372eaa51df94bc232",
    "totalScans": 42,
    "uniqueUsers": 35,
    "lastScanAt": "2025-07-22T08:30:15.000Z",
    "topRegions": [
      {
        "country": "CN",
        "region": "北京",
        "city": "北京",
        "scans": 25
      },
      {
        "country": "CN",
        "region": "上海",
        "city": "上海",
        "scans": 12
      },
      {
        "country": "CN",
        "region": "广东",
        "city": "深圳",
        "scans": 5
      }
    ]
  }
}

import axios from 'axios';
 
const API_KEY = 'xxxxxxxxxx';
const BASE_URL = '/api/v1';
 
// 获取二维码详情
async function getQRCodeDetail(id) {
  const response = await axios.get(`${BASE_URL}/qrcode/${id}`, {
    headers: {
      'cb-api-key': API_KEY
    }
  });
  return response.data;
}

 
# 获取二维码详情
curl -H "cb-api-key: {api_key}" \
     /api/v1/qrcode/687efd6372eaa51df94bc232
 
# 获取二维码统计
curl -H "cb-api-key: {api_key}" \
     /api/v1/qrcode/687efd6372eaa51df94bc232/stats