Error Handling

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

POST /v1/vendors

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "friendlyId": "V100001",
  "name": "ABC Warehouse Services",
  "status": "ACTIVE",
  ...
}

GET /v1/vendors/550e8400-e29b-41d4-a716-446655440000

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "friendlyId": "V100001",
  "name": "ABC Warehouse Services",
  ...
}

PATCH /v1/vendors/550e8400-e29b-41d4-a716-446655440000

HTTP/1.1 200 OK
Content-Type: application/json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "friendlyId": "V100001",
  "name": "ABC Warehouse Services Updated",
  ...
}

DELETE /v1/vendors/550e8400-e29b-41d4-a716-446655440000

HTTP/1.1 204 No Content

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ]
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid JSON in request body"
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or expired access token"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Vendor not found"
  }
}

{
  "error": {
    "code": "DUPLICATE_KEY",
    "message": "A vendor with this key already exists",
    "details": [
      {
        "field": "key",
        "message": "Key 'ERP-VENDOR-123' is already in use"
      }
    ]
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      },
      {
        "field": "phone",
        "message": "Phone number is required"
      }
    ]
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 30 seconds."
  }
}

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred"
  }
}

async function requestWithRetry(url, options, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    try {
      const response = await fetch(url, options);

      // Success - return response
      if (response.ok) {
        return response;
      }

      // Client errors (4xx) - don't retry (except 429)
      if (response.status >= 400 && response.status < 500) {
        if (response.status === 429) {
          // Rate limit - use exponential backoff
          const backoffMs = Math.pow(2, attempt) * 1000;
          await new Promise((resolve) => setTimeout(resolve, backoffMs));
          continue;
        }
        // Other 4xx errors - throw immediately
        throw new Error(`Client error: ${response.status}`);
      }

      // Server errors (5xx) - retry with backoff
      if (response.status >= 500) {
        const backoffMs = Math.pow(2, attempt) * 1000;
        await new Promise((resolve) => setTimeout(resolve, backoffMs));
        continue;
      }
    } catch (error) {
      // Network error - retry with backoff
      if (attempt < maxRetries - 1) {
        const backoffMs = Math.pow(2, attempt) * 1000;
        await new Promise((resolve) => setTimeout(resolve, backoffMs));
        continue;
      }
      throw error;
    }
  }

  throw new Error('Max retries exceeded');
}

import time
import requests
from typing import Optional

def request_with_retry(
    url: str,
    method: str = 'GET',
    max_retries: int = 3,
    **kwargs
) -> requests.Response:
    """Make HTTP request with exponential backoff retry"""
    for attempt in range(max_retries):
        try:
            response = requests.request(method, url, **kwargs)

            # Success
            if response.ok:
                return response

            # Client errors - don't retry (except 429)
            if 400 <= response.status_code < 500:
                if response.status_code == 429:
                    # Rate limit - use exponential backoff
                    backoff_seconds = 2 ** attempt
                    time.sleep(backoff_seconds)
                    continue
                # Other 4xx errors - raise immediately
                response.raise_for_status()

            # Server errors - retry with backoff
            if response.status_code >= 500:
                backoff_seconds = 2 ** attempt
                time.sleep(backoff_seconds)
                continue

        except requests.RequestException as e:
            # Network error - retry with backoff
            if attempt < max_retries - 1:
                backoff_seconds = 2 ** attempt
                time.sleep(backoff_seconds)
                continue
            raise

    raise Exception('Max retries exceeded')

console.error('Request failed:', {
  url: request.url,
  method: request.method,
  headers: request.headers,
  body: request.body,
  status: response.status,
  statusText: response.statusText,
  responseBody: await response.text(),
});

function validateVendorInput(vendor) {
  const errors = [];

  if (!vendor.name) {
    errors.push({ field: 'name', message: 'Name is required' });
  }

  if (vendor.email && !isValidEmail(vendor.email)) {
    errors.push({ field: 'email', message: 'Invalid email format' });
  }

  if (errors.length > 0) {
    throw new ValidationError('Invalid input', errors);
  }
}