API 文件

批量操作

批量創建 QR 碼

使用我們的 API 自動創建您的 QR 碼。一次創建數百或數千個 QR 碼，非常適合大型活動、產品標籤或資產追蹤。

CSV 匯入

上傳包含您的 QR 碼數據的 CSV 文件，我們將一次性創建所有 QR 碼。

API 批次

在單個 API 調用中使用 JSON 負載創建多個 QR 碼。

異步處理

大型匯入在背景中運行並進行狀態跟蹤。

端點

方法	端點	描述
POST	/organizations/:orgId/qr-codes/bulk-import	從 CSV 開始批量匯入
GET	/organizations/:orgId/qr-codes/bulk-import	列出所有匯入作業
GET	/organizations/:orgId/qr-codes/bulk-import/:id	獲取匯入作業狀態
GET	/organizations/:orgId/qr-codes/bulk-import/sample	下載 CSV 模板
POST	/organizations/:orgId/qr-codes/batch/update	批量更新多個 QR 碼
POST	/organizations/:orgId/qr-codes/batch/clone	複製多個 QR 碼
DELETE	/organizations/:orgId/qr-codes/batch	刪除多個 QR 碼

CSV 批量匯入

一次創建多個 QR 碼的最簡單方法是通過 CSV 匯入。請按照以下步驟操作：

下載 CSV 模板

獲取您 QR 碼類型的模板以確保格式正確。

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

填寫您的數據

將您的 QR 碼數據添加到 CSV 文件中。以下是 URL QR 碼的示例：

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

上傳 CSV 文件

發送文件以開始匯入作業。

開始匯入

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

監控匯入進度

檢查您的匯入作業狀態。

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

回應

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

CSV 列參考

每種 QR 碼類型需要不同的列。以下是最常見的列：

URL QR 碼

列	必填	描述
name	必填	QR 碼的顯示名稱
url	必填	目標 URL（必須以 http:// 或 https:// 開頭）
folder	選填	組織 QR 碼的資料夾名稱
tags	選填	用分號分隔的標籤

vCard QR 碼

列	必填	描述
name	必填	QR 碼的顯示名稱
firstName	必填	聯絡人的名字
lastName	必填	聯絡人的姓氏
email	選填	電子郵件地址
phone	選填	電話號碼
company	選填	公司名稱
title	選填	職稱

批量更新

通過一次 API 調用同時更新多個 QR 碼。

POST

/organizations/:orgId/qr-codes/batch/update

批量更新請求

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

匯入限制

最大行數

10,000

每個 CSV 文件的 QR 碼數量

文件大小限制

10 MB

最大 CSV 文件大小

提示： 對於非常大的匯入（10,000+ QR 碼），考慮將您的 CSV 拆分為多個文件並按順序匯入。

使用案例

產品標籤

為您庫存中的每個產品生成唯一的 QR 碼

行銷活動

為每位收件人創建個性化的 QR 碼

資產追蹤

標記設備、文件或實體資產

活動管理

生成帶有唯一 QR 碼的票證或徽章

下一步

了解相關功能：