API-dokumentation

curl "https://app.tabletimer.com/api/v1/metrics/catalog" \
  -H "Authorization: Bearer DIN_API_NØGLE"

// 1. Ved opsætning: hent kataloget og lad brugeren vælge sine widgets.
const { metrics } = await tabletimer('/api/v1/metrics/catalog')
// -> [{ key: 'covers', label: 'Kuverter', kind: 'scalar', unit: 'covers', ... }, ...]
// Gem brugerens valg, fx ['covers', 'revenue', 'noShowPct'].

// 2. Ved hver visning: hent kun de valgte.
const chosen = ['covers', 'revenue', 'noShowPct']
const { metrics: data } = await tabletimer(
  `/api/v1/metrics?period=30d&metrics=${chosen.join(',')}`
)

// 3. Tegn hver widget ud fra 'kind' og 'unit' — uden at kende det enkelte tal.
for (const m of data) {
  if (m.kind === 'scalar') {
    const value = m.unit === 'currency' ? m.value / 100 : m.value   // øre -> kroner
    render({ title: m.label, value, unit: m.unit, change: m.changePct })
  }
}

curl "https://app.tabletimer.com/api/v1/metrics?period=30d&metrics=covers,noShowPct" \
  -H "Authorization: Bearer DIN_API_NØGLE"

{
  "period": {
    "from": "2026-07-15", "to": "2026-08-13", "days": 30,
    "comparedTo": { "from": "2026-06-15", "to": "2026-07-14" }
  },
  "metrics": [
    {
      "key": "covers", "label": "Kuverter", "kind": "scalar", "unit": "covers",
      "value": 842, "previousValue": 751, "changePct": 12
    },
    {
      "key": "noShowPct", "label": "No-show", "kind": "scalar", "unit": "percent",
      "value": 3.44, "previousValue": 5.1, "changePct": -33
    }
  ]
}

curl "https://app.tabletimer.com/api/v1/metrics/daily?period=30d&amounts=dkk" \
  -H "Authorization: Bearer DIN_API_NØGLE"

{
  "period": { "from": "2026-07-15", "to": "2026-08-13", "days": 30 },
  "columns": [
    { "key": "date", "label": "Dato", "unit": "text" },
    { "key": "covers", "label": "Kuverter", "unit": "covers" },
    { "key": "revenue", "label": "Omsætning", "unit": "currency_dkk" }
  ],
  "rows": [
    { "date": "2026-07-15", "weekday": "Onsdag", "covers": 43, "revenue": 21450.00 },
    { "date": "2026-07-16", "weekday": "Torsdag", "covers": 0,  "revenue": 0 }
  ]
}

const BASE = 'https://app.tabletimer.com'
const KEY = process.env.TABLETIMER_API_KEY!

export async function tabletimer(path: string, init: RequestInit = {}) {
  const res = await fetch(BASE + path, {
    ...init,
    headers: {
      Authorization: `Bearer ${KEY}`,
      'Content-Type': 'application/json',
      ...init.headers,
    },
  })

  if (res.status === 429) {
    // Vent det svaret beder om — og prøv så igen.
    const wait = Number(res.headers.get('Retry-After') ?? 5)
    await new Promise((r) => setTimeout(r, wait * 1000))
    return tabletimer(path, init)
  }

  const body = await res.json()
  if (!res.ok) {
    // Forgren på 'code' — 'error' er en tekst til mennesker og kan omformuleres.
    throw Object.assign(new Error(body.error), { code: body.code, status: res.status })
  }
  return body
}

import { createHmac, timingSafeEqual } from 'crypto'

/**
 * Kald denne med den RÅ body — ikke det JSON.parse har lavet om på.
 * Ét mellemrum til forskel, og underskriften passer ikke længere.
 */
export function verifyTabletimer(rawBody: string, header: string, secret: string): boolean {
  const parts = new Map(header.split(',').map((p) => p.split('=') as [string, string]))
  const t = Number(parts.get('t'))
  const received = parts.get('v1')
  if (!Number.isFinite(t) || !received) return false

  // Afvis gamle beskeder, så en opsnappet besked ikke kan gensendes i morgen.
  if (Math.abs(Date.now() / 1000 - t) > 300) return false

  const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex')
  const a = Buffer.from(expected, 'hex')
  const b = Buffer.from(received, 'hex')
  return a.length === b.length && timingSafeEqual(a, b)
}