Error Handling

class HookedError extends Error {
  constructor(status, body) {
    super(body.message ?? `HTTP ${status}`);
    this.status = status;
    this.code = body.code ?? body.errorCode ?? null;
    this.body = body;
  }
}

async function hooked(path, { method = "GET", body } = {}) {
  const res = await fetch(`https://api.hooked.so/v1${path}`, {
    method,
    headers: {
      "x-api-key": process.env.HOOKED_API_KEY,
      "Content-Type": "application/json",
    },
    body: body ? JSON.stringify(body) : undefined,
  });
  const json = await res.json().catch(() => ({}));
  if (!res.ok) throw new HookedError(res.status, json);
  return json;
}

try {
  const { data } = await hooked("/project/create/talking-avatar", {
    method: "POST",
    body: { avatarId: "1", script: "Hello there!" },
  });
  console.log("Project", data.projectId);
} catch (error) {
  if (!(error instanceof HookedError)) throw error; // network error: do NOT auto-retry a create

  switch (error.status) {
    case 400:
      console.error("Fix the request:", error.message);
      break;
    case 401:
      console.error("Check HOOKED_API_KEY");
      break;
    case 402:
      if (error.code === "missing_credentials") {
        console.error("Add these keys in Settings → AI keys:", error.body.missingProviders);
      } else if (error.body.errorCode === "INSUFFICIENT_CREDITS") {
        console.error(`Need ${error.body.creditsNeeded} credits, have ${error.body.creditsAvailable}`);
      } else {
        console.error("Subscription required");
      }
      break;
    default:
      console.error(`HTTP ${error.status}:`, error.message);
  }
}

import os
import requests


class HookedError(Exception):
    def __init__(self, status, body):
        super().__init__(body.get("message", f"HTTP {status}"))
        self.status = status
        self.code = body.get("code") or body.get("errorCode")
        self.body = body


def hooked(method, path, json=None):
    res = requests.request(
        method,
        f"https://api.hooked.so/v1{path}",
        headers={"x-api-key": os.environ["HOOKED_API_KEY"]},
        json=json,
        timeout=60,
    )
    try:
        body = res.json()
    except ValueError:
        body = {}
    if not res.ok:
        raise HookedError(res.status_code, body)
    return body


try:
    created = hooked("POST", "/project/create/talking-avatar", {"avatarId": "1", "script": "Hello there!"})
    print("Project", created["data"]["projectId"])
except HookedError as error:
    if error.status == 402 and error.code == "missing_credentials":
        print("Add these keys in Settings → AI keys:", error.body["missingProviders"])
    elif error.status == 402 and error.body.get("errorCode") == "INSUFFICIENT_CREDITS":
        print("Not enough credits:", error.body.get("creditsNeeded"), "needed")
    else:
        print(f"HTTP {error.status}: {error}")