b59.link API

// 1a. Have an API key? Swap it for a session key
let res = await fetch("https://b59.link/api/auth", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ api_key: process.env.B59_API_KEY }),
});
const { session_key } = await res.json();

// 1b. No key? Email code instead (signs the email up if new)
await fetch("https://b59.link/api/auth", { method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "bot@example.com" }) });
// ...read the 6-digit code from the inbox, then:
res = await fetch("https://b59.link/api/auth", { method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "bot@example.com", otp: "123456" }) });
// -> { session_key, api_key, expires_at, email }

// 2. Send it on every call for 300 requests/minute
await fetch("https://b59.link/api/auth/me", {
  headers: { Authorization: `Bearer ${session_key}` },
});

// Create a page-view tracker and get the tag for your pages
const res = await fetch("https://b59.link/api/trackers", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${sessionKey}`, // optional: the tracker belongs to you
  },
  body: JSON.stringify({ site_url: "example.com", name: "My blog" }),
});
const t = await res.json();
console.log(t.tag_url);    // https://b59.link/tag?<uuid>
console.log(t.snippet_js); // paste before </body>
console.log(t.stats_url);  // https://b59.link/tracker/<uuid>

// Where are the stats for this page / link / QR code?
const q = "https://example.com/pricing"; // or a slug, short URL, domain, tracker id
const res = await fetch(`https://b59.link/api/stats-url?q=${encodeURIComponent(q)}`);
const { found, results } = await res.json();
results.forEach((r) => console.log(r.type, r.stats_url));

// Shorten a URL
const res = await fetch("https://b59.link/api/shorten", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    url: "https://example.com/very/long/path",
    slug: "my-link",   // optional
  }),
});
const data = await res.json();
console.log(data.short_url); // https://b59.link/my-link
console.log(data.slug);      // my-link

// Generate a QR code (also creates a short link)
const res = await fetch("https://b59.link/api/qr", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ url: "https://example.com" }),
});
const data = await res.json();
// data.qr_code_data is a base64-encoded PNG
const img = document.createElement("img");
img.src = `data:image/png;base64,${data.qr_code_data}`;
document.body.appendChild(img);

// Any text -> QR image. Use the URL directly in an <img>.
const params = new URLSearchParams({
  data: "WIFI:T:WPA;S:Cafe;P:coffee123;;",
  size: "400", fg: "09c269", bg: "ffffff", format: "svg",
});
document.querySelector("img").src = `https://b59.link/api/tools/qr?${params}`;

// Check if a URL already has a b59 link (handles http/https/www variations)
const url = "https://example.com";
const res = await fetch(
  `https://b59.link/api/links/lookup?url=${encodeURIComponent(url)}`
);
const data = await res.json();
if (data.found) {
  console.log(data.short_url);   // https://b59.link/cool-jump
  console.log(data.stats_url);   // https://b59.link/stats/cool-jump
  // data.qr_code_data — base64 PNG if QR exists
} else {
  console.log("No link yet — create one with POST /qr");
}