MostlyQR

Batch

Crea migliaia di link dinamici in una singola chiamata. La creazione in batch è asincrona: invii il set, ricevi un job_id immediatamente e polling per il completamento. Stesso engine e quota dynamic_codes di una singola creazione. Pro+.

# Invia un batch

Passa un array JSON links oppure una stringa csv (RFC-4180, riga di intestazione 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 invece:

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

# Polling del 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 è uno tra queued, running, done, failed. Una volta done, i nuovi link vengono visualizzati tramite GET /v1/links.

# Note

  • Il job è suddiviso in chunk ed è riprendibile — i grandi import non faranno scadere il timeout della richiesta.
  • Le righe oltre la tua quota dynamic_codes vengono rifiutate; il job segnala errors per riga.
  • Per un codice univoco per unità fisica (non per destinazione), usa serialized codes invece.

# Prossimi passi