MostlyQR

Batch

Maak duizenden dynamische links in één aanroep. Batch-creatie is asynchrone: u dient de verzameling in, krijgt onmiddellijk een job_id terug en vraagt naar voltooiing. Dezelfde engine en dynamic_codes-quotum als één creatie. Pro+.

# Een batch indienen

Geef een JSON links-array of een csv-tekenreeks (RFC-4180, headerrij 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 }

In plaats daarvan CSV:

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

# Poll de job

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 is één van queued, running, done, failed. Zodra done, verschijnen de nieuwe links via GET /v1/links.

# Opmerkingen

  • De job is opgedeeld en hersteelbaar — grote imports veroorzaken geen time-out van het verzoek.
  • Rijen boven uw dynamic_codes-quotum worden geweigerd; de job meldt per rij errors.
  • Voor een unieke code per fysieke eenheid (niet per bestemming), gebruik in plaats daarvan geserialiseerde codes.

# Volgende