MostlyQR

バッチ

1回の呼び出しで数千の動的リンクを作成します。バッチ作成は非同期です：セットを送信してjob_idをすぐに取得し、完了をポーリングします。単一作成と同じエンジンとdynamic_codesクォータを使用します。Pro+。

# バッチを送信

JSON links配列またはCSV文字列（RFC-4180、ヘッダー行 destination_url[,title][,folder]）のいずれかを渡します。

bash
curl https://mostlyqr.com/api/v1/batch/links \
  -H "Authorization: Bearer mtq_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "links": [
      { "destination_url": "https://example.com/a", "title": "Flyer A" },
      { "destination_url": "https://example.com/b", "title": "Flyer B" }
    ],
    "folder_id": "fld-spring"
  }'
json
{ "job_id": "7f3a2c9b", "total": 2, "queued": true }

代わりにCSV：

json
{ "csv": "destination_url,title\nhttps://example.com/a,Flyer A\nhttps://example.com/b,Flyer B" }

# ジョブをポーリング

bash
curl https://mostlyqr.com/api/v1/batch/jobs/7f3a2c9b \
  -H "Authorization: Bearer mtq_live_…"
json
{ "job_id": "7f3a2c9b", "status": "done", "total": 2, "created": 2, "progress": 1 }

statusはqueued、running、done、failedのいずれかです。doneになると、新しいリンクはGET /v1/links経由で表示されます。

# 注意

  • ジョブはチャンク化され再開可能です — 大規模なインポートはリクエストがタイムアウトしません。
  • dynamic_codesクォータを超える行は拒否されます；ジョブは行ごとのerrorsを報告します。
  • 物理単位ごと（目的地ごとではなく）の一意なコードについては、代わりにシリアル化コードを使用してください。

# 次