MostlyQR

Lote

Crie milhares de links dinâmicos em uma única chamada. A criação em lote é assíncrona: você envia o conjunto, recebe um job_id imediatamente e pesquisa a conclusão. Mesmo mecanismo e cota de dynamic_codes de uma única criação. Pro+.

# Enviar um lote

Passe um array de links JSON ou uma string csv (RFC-4180, linha de cabeçalho 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 }

Usando CSV:

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

# Pesquisar o trabalho

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 é um de queued, running, done, failed. Assim que done, os novos links aparecem via GET /v1/links.

# Observações

  • O trabalho é dividido em chunks e retomável — grandes importações não expirarão a solicitação.
  • Linhas acima de sua cota de dynamic_codes são rejeitadas; o trabalho reporta errors por linha.
  • Para um código único por unidade física (não por destino), use códigos serializados.

# Próximo