APIドキュメンテーション

バルク操作

バルクQRコード作成

APIを使用してQRコードの作成を自動化します。一度に数百または数千のQRコードを作成でき、大規模なキャンペーン、製品ラベリング、資産追跡に最適です。

CSVインポート

QRコードデータを含むCSVファイルをアップロードすると、すべてを一度に作成します。

APIバッチ

JSONペイロードを使用して1回のAPI呼び出しで複数の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コードでチケットやバッジを生成

次のステップ