Interactive PDF Presentation

// Node.js example using fetch (Node 18+). Nadia, backend engineer, uses this in a service layer.

import { setTimeout as delay } from "node:timers/promises";

const baseUrl = "https://api.interactive-pdf.example.com/v1";
const apiKey = process.env.INTERACTIVE_PDF_API_KEY; // e.g., set in your deployment environment

if (!apiKey) {
  throw new Error("Missing INTERACTIVE_PDF_API_KEY");
}

async function createPresentation(payload) {
  const res = await fetch(`${baseUrl}/presentations`, {
    method: "POST",
    headers: {
      // Required authentication format
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(payload),
    // Optional: enforce client-side timeout via AbortController in production code
  });

  // Error handling: non-2xx responses include JSON error payloads (see Response Format)
  const json = await res.json().catch(() => ({}));
  if (!res.ok) {
    const msg = json?.error?.message || `HTTP ${res.status}`;
    throw new Error(msg);
  }

  return json;
}

// Example payload shape depends on your presentation creation contract.
const presentation = await createPresentation({
  title: "Quarterly Results",
  source: { type: "pdf", uri: "https://storage.example.com/input.pdf" },
});
console.log(presentation.presentationId);

{
  "requestId": "req_01J2...Z9",
  "presentationId": "pres_01J2...AB",
  "status": "created",
  "expiresAt": "2026-04-05T12:34:56Z",
  "error": null
}

{
  "requestId": "req_01J2...Z9",
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key",
    "details": {
      "header": "Authorization",
      "expected": "Bearer "
    }
  }
}