MostlyQR

Batch

Erstellen Sie Tausende von dynamischen Links in einem Aufruf. Batch-Erstellung ist asynchron: Sie reichen den Satz ein, erhalten sofort eine job_id zurück und fragen dann den Abschluss ab. Gleiches System und dynamic_codes-Kontingent wie bei einer einzelnen Erstellung. Pro+.

# Batch einreichen

Übergeben Sie entweder ein JSON-Array links oder einen csv-String (RFC-4180, Header-Zeile 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": "imp_abc123", "total": 2, "queued": true }

CSV statt JSON:

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

# Job abfragen

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

status ist eines von queued, running, done, failed. Sobald done, erscheinen die neuen Links über GET /v1/links.

# Hinweise

  • Der Job ist aufgeteilt und wiederaufnehmbar – große Importe verursachen keine Anfragetimeouts.
  • Zeilen, die Ihr dynamic_codes-Kontingent überschreiten, werden abgelehnt; der Job meldet pro Zeile errors.
  • Für einen eindeutigen Code pro physischer Einheit (nicht pro Ziel) verwenden Sie stattdessen serialisierte Codes.

# Nächste Schritte