API 文档

批量操作

批量创建二维码

使用我们的API自动创建您的二维码。一次创建数百或数千个二维码，适合大型活动、产品标签或资产跟踪。

CSV导入

上传包含您的二维码数据的CSV文件，我们将一次性创建所有二维码。

API批处理

在单个API调用中使用JSON负载创建多个二维码。

异步处理

大型导入在后台运行并进行状态跟踪。

端点

方法	端点	描述
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	批量更新多个二维码
POST	/organizations/:orgId/qr-codes/batch/clone	克隆多个二维码
DELETE	/organizations/:orgId/qr-codes/batch	删除多个二维码

CSV批量导入

一次创建多个二维码的最简单方法是通过CSV导入。请按照以下步骤操作：

下载CSV模板

获取您的二维码类型的模板以确保格式正确。

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

填写您的数据

将您的二维码数据添加到CSV文件中。以下是URL二维码的示例：

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列参考

每种二维码类型需要不同的列。以下是最常见的列：

URL二维码

列	必需	描述
name	必需	二维码的显示名称
url	必需	目标URL（必须以http://或https://开头）
folder	可选	组织二维码的文件夹名称
tags	可选	用分号分隔的标签

vCard二维码

列	必需	描述
name	必需	二维码的显示名称
firstName	必需	联系人的名字
lastName	必需	联系人的姓氏
email	可选	电子邮件地址
phone	可选	电话号码
company	可选	公司名称
title	可选	职位

批量更新

使用单个API调用一次更新多个二维码。

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文件的二维码数量

文件大小限制

10 MB

最大CSV文件大小

提示： 对于非常大的导入（10,000+ 个二维码），考虑将您的 CSV 拆分为多个文件并按顺序导入。

用例

产品标签

为您库存中的每个产品生成唯一的二维码

营销活动

为每个收件人创建个性化的二维码

资产跟踪

标记设备、文档或实物资产

事件管理

生成带有唯一二维码的票证或徽章

下一步

了解相关功能：