Confera DEV
Use Case • Schedule

Schedule on Your Site

Show the conference schedule on a custom website (not Confera).

Goal

You want a schedule page on your own website. Confera remains the source of truth.

What you need

  • An API key with events:read.
  • A server (Next.js, Node, PHP, Python, etc.) to keep the key secret.

Fetch data

Using the SDK
ts
import { createConferaPublicClient } from "@confera/sdk";

const confera = createConferaPublicClient({
  baseUrl: "https://your-domain",
  apiKey: process.env.CONFERA_API_KEY!,
});

const events = await confera.events.list({ limit: 200 });
const venues = await confera.events.listVenues({ limit: 200 });
const speakers = await confera.events.listSpeakers({ limit: 500 });

Render

Most sites render a list grouped by day → venue → time.

Pseudo rendering
ts
// render(events.data)
// - group by date
// - sort by start time
// - attach venue + speakers by id
// - show “now/live” label if current time is within start/end

Caching

Schedule data can be cached for short periods (e.g. 30–120 seconds) for speed.

Next.js example
ts
await fetch("https://your-domain/api/public/v1/events/events", {
  headers: { "X-API-Key": process.env.CONFERA_API_KEY! },
  next: { revalidate: 60 },
});