Cal ID API Rate Limits

async function calIdRequest(path, options = {}, attempt = 1) {
  const res = await fetch(`https://api.cal.id${path}`, {
    ...options,
    headers: {
      Authorization: `Bearer ${process.env.CALID_KEY}`,
      ...options.headers,
    },
  });

  console.log("Remaining:", res.headers.get("X-RateLimit-Remaining"));

  if (res.status === 429) {
    if (attempt >= 5) throw new Error("Still rate limited after 5 attempts");
    const throttled = await res.json();
    // Wait retryAfter seconds, doubling the delay on each attempt.
    const waitSeconds = (throttled.retryAfter ?? 30) * 2 ** (attempt - 1);
    await new Promise((resolve) => setTimeout(resolve, waitSeconds * 1000));
    return calIdRequest(path, options, attempt + 1);
  }

  const body = await res.json();
  // A 500 is often NOT transient — read the message before retrying it.
  if (!res.ok) throw new Error(body.message ?? `HTTP ${res.status}`);
  return body.data;
}

calIdRequest("/users/me").then((user) => console.log(user.username));

import os
import time

import requests

CALID_KEY = os.environ["CALID_KEY"]


def cal_id_request(path, max_attempts=5):
    for attempt in range(max_attempts):
        response = requests.get(
            f"https://api.cal.id{path}",
            headers={"Authorization": f"Bearer {CALID_KEY}"},
        )
        print("Remaining:", response.headers.get("X-RateLimit-Remaining"))

        if response.status_code == 429:
            # Wait retryAfter seconds, doubling the delay on each attempt.
            retry_after = response.json().get("retryAfter", 30)
            time.sleep(retry_after * 2**attempt)
            continue

        # A 500 is often NOT transient — read the message before retrying it.
        response.raise_for_status()
        return response.json()["data"]

    raise RuntimeError("Still rate limited after 5 attempts")


print(cal_id_request("/users/me")["username"])