Lote
Crea miles de enlaces dinámicos en una sola llamada. La creación en lote es asincrónica: envías el conjunto, recibes un job_id inmediatamente, y consultas el progreso. Mismo motor y cuota de dynamic_codes que una creación única. Pro+.
# Enviar un lote
Pasa un array links JSON o una cadena csv (RFC-4180, fila de encabezado destination_url[,title][,folder]).
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"
}'
{ "job_id": "imp_abc123", "total": 2, "queued": true }
CSV en su lugar:
{ "csv": "destination_url,title\nhttps://example.com/a,Flyer A\nhttps://example.com/b,Flyer B" }
# Consultar el trabajo
curl https://mostlyqr.com/api/v1/batch/jobs/imp_abc123 \
-H "Authorization: Bearer mtq_live_…"
{ "job_id": "imp_abc123", "status": "done", "total": 2, "created": 2, "progress": 1 }
status es uno de queued, running, done, failed. Una vez done, los nuevos enlaces aparecen a través de GET /v1/links.
# Notas
- El trabajo se divide en fragmentos y es reanudable — las importaciones grandes no agotarán el tiempo de espera de la solicitud.
- Las filas que excedan tu cuota de
dynamic_codesse rechazan; el trabajo reportaerrorspor fila. - Para un código único por unidad física (no por destino), utiliza códigos serializados en su lugar.
# Siguiente
- Códigos serializados · la referencia API completa.