Acoustic Index Read API

const baseUrl = "https://acousticindex.com/api/v1";
const apiKey = process.env.ACOUSTIC_INDEX_API_KEY!;

async function apiFetch(path: string, init: RequestInit = {}) {
  const response = await fetch(`${baseUrl}${path}`, {
    ...init,
    headers: {
      Authorization: `Bearer ${apiKey}`,
      ...(init.headers ?? {}),
    },
  });

  if (!response.ok) {
    const body = await response.json().catch(() => ({ error: "unknown" }));
    throw new Error(`${response.status} ${body.error}: ${body.message}`);
  }

  return { data: await response.json(), headers: response.headers };
}

// Search with acoustic ratings inline (alpha_w / nrc / saa per hit)
const { data: search } = await apiFetch("/materials/search?q=wood&include=acoustics&limit=20");
console.log(`Found ${search.total_count} materials, has_more: ${search.has_more}`);

// Fetch detail with ETag caching
const id = search.items[0]?.id;
if (id) {
  const { data, headers } = await apiFetch(`/materials/${id}`);
  const etag = headers.get("ETag");

  // Re-fetch with If-None-Match -- returns 304 if unchanged
  const cached = await fetch(`${baseUrl}/materials/${id}`, {
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "If-None-Match": etag ?? "",
    },
  });
  console.log(cached.status); // 304 if unchanged
}