Error Handling

Handle errors with the Fathom SDKs

Error Handling

Both TypeScript and Python SDKs provide comprehensive error handling capabilities. The base error class is FathomError for both SDKs.

Basic Error Handling

TypeScript

import { Fathom } from 'fathom-typescript';
import * as errors from 'fathom-typescript/models/errors';

const fathom = new Fathom({
  security: {
    apiKeyAuth: "YOUR_API_KEY"
  }
});

try {
  const result = await fathom.listMeetings({});
  for await (const page of result) {
    console.log(page);
  }
} catch (error) {
  if (error instanceof errors.FathomError) {
    console.log(error.message);
    console.log(error.statusCode);
    console.log(error.body);
    console.log(error.headers);
  }
}

from fathom_python import Fathom, errors, models

with Fathom(
    security=models.Security(
        api_key_auth="YOUR_API_KEY",
    ),
) as fathom:
    try:
        res = fathom.list_meetings()
        while res is not None:
            print(res)
            res = res.next()
    except errors.FathomError as e:
        print(f"Error: {e.message}")
        print(f"Status Code: {e.status_code}")
        print(f"Body: {e.body}")
        print(f"Headers: {e.headers}")

Handle Specific Status Codes

TypeScript

import { Fathom } from 'fathom-typescript';
import * as errors from 'fathom-typescript/models/errors';

async function handleSpecificErrors() {
  const fathom = new Fathom({
    security: {
      apiKeyAuth: "YOUR_API_KEY"
    }
  });

  try {
    const result = await fathom.listMeetings({});
    return result;
  } catch (error) {
    if (error instanceof errors.FathomError) {
      switch (error.statusCode) {
        case 401:
          console.log("Authentication failed. Check your API key.");
          break;
        case 403:
          console.log("Access forbidden. Check your permissions.");
          break;
        case 404:
          console.log("Resource not found.");
          break;
        case 429:
          console.log("Rate limit exceeded. Try again later.");
          break;
        default:
          if (error.statusCode >= 500) {
            console.log("Server error. Try again later.");
          } else {
            console.log(`Unexpected error: ${error.message}`);
          }
      }
    }
    return null;
  }
}

from fathom_python import Fathom, errors, models

def handle_specific_errors():
    with Fathom(
        security=models.Security(
            api_key_auth="YOUR_API_KEY",
        ),
    ) as fathom:
        try:
            res = fathom.list_meetings()
            return res
        except errors.FathomError as e:
            if e.status_code == 401:
                print("Authentication failed. Check your API key.")
            elif e.status_code == 403:
                print("Access forbidden. Check your permissions.")
            elif e.status_code == 404:
                print("Resource not found.")
            elif e.status_code == 429:
                print("Rate limit exceeded. Try again later.")
            elif e.status_code >= 500:
                print("Server error. Try again later.")
            else:
                print(f"Unexpected error: {e.message}")
            return None

Error Classes

Primary error:

• FathomError: The base class for HTTP error responses.

Network errors (TypeScript):

• ConnectionError: HTTP client was unable to make a request to a server.
• RequestTimeoutError: HTTP request timed out due to an AbortSignal signal.
• RequestAbortedError: HTTP request was aborted by the client.
• InvalidRequestError: Any input used to create a request is invalid.
• UnexpectedClientError: Unrecognised or unexpected error.

Network errors (Python):

• httpx.RequestError: Base class for request errors.
• httpx.ConnectError: HTTP client was unable to make a request to a server.
• httpx.TimeoutException: HTTP request timed out.

Inherit from FathomError:

• ResponseValidationError: Type mismatch between the response data and the expected model structure.