Handle Octogen API errors in your integration

import asyncio
from octogen_ai_sdk import (
    OctogenClient,
    OctogenAuthenticationError,
    OctogenConnectionError,
    OctogenForbiddenError,
    OctogenNotFoundError,
    OctogenValidationError,
    OctogenAPIError,
)

async def main() -> None:
    async with OctogenClient() as client:
        try:
            result = await client.lookup_product(
                "https://warrenlotas.com/products/black-hoodie"
            )
            print(result.product.title)

        except OctogenAuthenticationError:
            # 401 — rotate or replace the API key
            print("Invalid API key. Check OCTO_API_KEY and rotate if needed.")

        except OctogenForbiddenError as exc:
            # 403 — org does not have access
            print(f"Access denied: {exc.detail}")

        except OctogenNotFoundError as exc:
            # 404 — catalog or product not found
            print(f"Not found: {exc.detail}")

        except OctogenValidationError as exc:
            # 422 — fix the request fields
            print(f"Validation error: {exc.detail}")

        except OctogenConnectionError as exc:
            # Network failure — safe to retry with backoff
            print(f"Connection error: {exc}")

        except OctogenAPIError as exc:
            # Catch-all for unexpected 5xx or other API errors
            print(f"API error {exc.status_code}: {exc.detail}")
            raise

asyncio.run(main())

import {
  OctogenClient,
  OctogenAuthenticationError,
  OctogenConnectionError,
  OctogenForbiddenError,
  OctogenNotFoundError,
  OctogenValidationError,
  OctogenAPIError,
} from "@octogen-ai/sdk";

const client = new OctogenClient();

try {
  const result = await client.lookupProduct(
    "https://warrenlotas.com/products/black-hoodie"
  );
  console.log(result.product.title);
} catch (error) {
  if (error instanceof OctogenAuthenticationError) {
    // 401 — rotate or replace the API key
    console.error("Invalid API key. Check OCTO_API_KEY and rotate if needed.");
  } else if (error instanceof OctogenForbiddenError) {
    // 403 — org does not have access
    console.error("Access denied:", error.detail);
  } else if (error instanceof OctogenNotFoundError) {
    // 404 — catalog or product not found
    console.error("Not found:", error.detail);
  } else if (error instanceof OctogenValidationError) {
    // 422 — fix the request fields
    console.error("Validation error:", error.detail);
  } else if (error instanceof OctogenConnectionError) {
    // Network failure — safe to retry with backoff
    console.error("Connection error:", error.message);
  } else if (error instanceof OctogenAPIError) {
    // Catch-all for unexpected 5xx or other API errors
    console.error(`API error ${String(error.statusCode)}:`, error.detail);
    throw error;
  } else {
    throw error;
  }
}