Export

curl "https://boards.example.com/api/data/board-export?boardId=12" \
  -H "X-API-Key: $LOKALBOARDS_KEY" \
  -o website-relaunch.zip

import { writeFile } from "node:fs/promises";

const response = await fetch(
  "https://boards.example.com/api/data/board-export?boardId=12",
  { headers: { "X-API-Key": apiKey } },
);

if (!response.ok) throw new Error(await response.text());

await writeFile("website-relaunch.zip", Buffer.from(await response.arrayBuffer()));

<script setup>
const config = useRuntimeConfig();

async function download() {
  const zip = await $fetch("https://boards.example.com/api/data/board-export", {
    headers: { "X-API-Key": config.lokalBoardsKey },
    query: { boardId: 12 },
    responseType: "blob",
  });

  const link = document.createElement("a");
  link.href = URL.createObjectURL(zip);
  link.download = "website-relaunch.zip";
  link.click();
  URL.revokeObjectURL(link.href);
}
</script>

<template>
  <button type="button" @click="download">Export board</button>
</template>

export function ExportButton({ apiKey, boardId }) {
  async function download() {
    const response = await fetch(
      `https://boards.example.com/api/data/board-export?boardId=${boardId}`,
      { headers: { "X-API-Key": apiKey } },
    );
    if (!response.ok) throw new Error(await response.text());

    const link = document.createElement("a");
    link.href = URL.createObjectURL(await response.blob());
    link.download = `board-${boardId}.zip`;
    link.click();
    URL.revokeObjectURL(link.href);
  }

  return <button onClick={download}>Export board</button>;
}

<?php

$file = fopen('website-relaunch.zip', 'w');
$ch = curl_init('https://boards.example.com/api/data/board-export?boardId=12');

curl_setopt($ch, CURLOPT_FILE, $file);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $apiKey,
]);

curl_exec($ch);
curl_close($ch);
fclose($file);

# Nightly, from cron: one dated zip per day.
curl "https://boards.example.com/api/data/export" \
  -H "X-API-Key: $LOKALBOARDS_ADMIN_KEY" \
  --fail -o "lokalboards-$(date +%F).zip"

import { createWriteStream } from "node:fs";
import { Readable } from "node:stream";
import { pipeline } from "node:stream/promises";

const response = await fetch("https://boards.example.com/api/data/export", {
  headers: { "X-API-Key": adminKey },
});

if (!response.ok) throw new Error(await response.text());

// Streamed to disk rather than held in memory: this can be large.
await pipeline(
  Readable.fromWeb(response.body),
  createWriteStream(`lokalboards-${new Date().toISOString().slice(0, 10)}.zip`),
);

<script setup>
// In an internal tool running on the same instance, where the administrator is
// already signed in: a plain link is enough, and the browser streams it.
</script>

<template>
  <a href="/api/data/export">Export all data</a>
</template>

// Same instance, administrator signed in: the session cookie does the rest.
export function ExportAll() {
  return <a href="/api/data/export">Export all data</a>;
}

<?php

$file = fopen('lokalboards-' . date('Y-m-d') . '.zip', 'w');
$ch = curl_init('https://boards.example.com/api/data/export');

curl_setopt($ch, CURLOPT_FILE, $file);
curl_setopt($ch, CURLOPT_TIMEOUT, 0);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-Key: ' . $adminKey,
]);

curl_exec($ch);
curl_close($ch);
fclose($file);