Generate and manage QR codes at scale: bulk + folders

curl -s https://openqr.uk/v1/dynamic/bulk \
  -H "Authorization: Bearer oqr_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "codes": [
      { "destination": "https://acme.com/listing/12-oak-avenue", "label": "12 Oak Avenue" },
      { "destination": "https://acme.com/listing/4-elm-court",   "label": "4 Elm Court" }
    ]
  }'

{
  "created": [
    {
      "id": "9b1c…",
      "slug": "k7Hq2mP",
      "short_url": "https://oqr.to/k7Hq2mP",
      "destination": "https://acme.com/listing/12-oak-avenue",
      "label": "12 Oak Avenue"
    },
    {
      "id": "3f8a…",
      "slug": "Tn4xR9d",
      "short_url": "https://oqr.to/Tn4xR9d",
      "destination": "https://acme.com/listing/4-elm-court",
      "label": "4 Elm Court"
    }
  ]
}

import { readFileSync, writeFileSync } from "node:fs";

const API = "https://openqr.uk";
const KEY = process.env.OPENQR_KEY; // "oqr_…"
const BULK_MAX = 200;

const headers = {
  "Authorization": `Bearer ${KEY}`,
  "Content-Type": "application/json",
};

// Minimal CSV reader: expects a "destination,label" header row.
function readCsv(path) {
  const [head, ...lines] = readFileSync(path, "utf8").trim().split(/\r?\n/);
  const cols = head.split(",").map((c) => c.trim());
  return lines.map((line) => {
    const cells = line.split(",");
    return Object.fromEntries(cols.map((c, i) => [c, (cells[i] ?? "").trim()]));
  });
}

function chunk(arr, size) {
  const out = [];
  for (let i = 0; i < arr.length; i += size) out.push(arr.slice(i, i + size));
  return out;
}

async function api(path, init) {
  const res = await fetch(API + path, { ...init, headers });
  if (!res.ok) throw new Error(`${path} → ${res.status}: ${await res.text()}`);
  return res.json();
}

async function main() {
  const rows = readCsv(process.argv[2] ?? "destinations.csv");
  if (!rows.length) throw new Error("No rows in CSV.");

  // 1. One folder for this print run.
  const folder = await api("/v1/folders", {
    method: "POST",
    body: JSON.stringify({ name: `Print run ${new Date().toISOString().slice(0, 10)}` }),
  });

  // 2. Bulk-create in batches of <=200, collecting every created code.
  const created = [];
  for (const batch of chunk(rows, BULK_MAX)) {
    const codes = batch.map((r) => ({ destination: r.destination, label: r.label }));
    const { created: made } = await api("/v1/dynamic/bulk", {
      method: "POST",
      body: JSON.stringify({ codes }),
    });
    created.push(...made);
  }

  // 3. File each code into the folder (bulk can't set folder_id directly).
  for (const c of created) {
    await api(`/v1/dynamic/${c.id}`, {
      method: "PATCH",
      body: JSON.stringify({ folder_id: folder.id }),
    });
  }

  // 4. Write the print map: label -> short_url.
  const csv = ["label,short_url", ...created.map((c) => `${c.label ?? ""},${c.short_url}`)].join("\n");
  writeFileSync("print-map.csv", csv);
  console.log(`Created ${created.length} codes in folder "${folder.name}". Wrote print-map.csv.`);
}

main().catch((e) => { console.error(e); process.exit(1); });

import csv, os, requests

API, KEY, BULK_MAX = "https://openqr.uk", os.environ["OPENQR_KEY"], 200
H = {"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"}

rows = list(csv.DictReader(open("destinations.csv")))  # columns: destination,label
folder = requests.post(f"{API}/v1/folders", json={"name": "Print run"}, headers=H).json()

created = []
for i in range(0, len(rows), BULK_MAX):
    batch = [{"destination": r["destination"], "label": r["label"]} for r in rows[i:i + BULK_MAX]]
    r = requests.post(f"{API}/v1/dynamic/bulk", json={"codes": batch}, headers=H)
    r.raise_for_status()
    created += r.json()["created"]

for c in created:
    requests.patch(f"{API}/v1/dynamic/{c['id']}", json={"folder_id": folder["id"]}, headers=H)

with open("print-map.csv", "w", newline="") as f:
    w = csv.writer(f); w.writerow(["label", "short_url"])
    w.writerows([[c.get("label") or "", c["short_url"]] for c in created])