Error Handling Guide

#!/bin/bash

# SearchHive API error handling script
API_KEY="sk_live_your_key_here"
BASE_URL="https://www.searchhive.dev/api/v1"
MAX_RETRIES=3

make_api_request() {
    local endpoint="$1"
    local data="$2"
    local attempt=1
    
    while [ $attempt -le $MAX_RETRIES ]; do
        echo "Attempt $attempt of $MAX_RETRIES"
        
        # Make the request and capture response + status code
        response=$(curl -s -w "%{json}%{http_code}" \
            -X POST "$BASE_URL/$endpoint" \
            -H "Authorization: Bearer $API_KEY" \
            -H "Content-Type: application/json" \
            -d "$data" \
            --max-time 30)
        
        # Extract status code (last 3 characters)
        http_code="${response: -3}"
        # Extract response body (everything except last 3 characters)
        response_body="${response%???}"
        
        case $http_code in
            200)
                echo "✅ Success!"
                echo "$response_body" | jq '.'
                return 0
                ;;
            400)
                echo "❌ Bad Request (400)"
                echo "$response_body" | jq -r '.error // "Invalid request parameters"'
                return 1
                ;;
            401)
                echo "🔒 Unauthorized (401)"
                echo "Please check your API key"
                return 1
                ;;
            402)
                echo "💳 Payment Required (402)"
                echo "Insufficient credits - please upgrade your plan"
                return 1
                ;;
            429)
                echo "⏰ Rate Limited (429)"
                retry_after=$(echo "$response_body" | jq -r '.retry_after // 60')
                if [ $attempt -lt $MAX_RETRIES ]; then
                    echo "Waiting $retry_after seconds before retry..."
                    sleep "$retry_after"
                    attempt=$((attempt + 1))
                    continue
                else
                    echo "Max retries exceeded"
                    return 1
                fi
                ;;
            5*)
                echo "🔧 Server Error ($http_code)"
                if [ $attempt -lt $MAX_RETRIES ]; then
                    wait_time=$((2 ** (attempt - 1)))
                    echo "Retrying in $wait_time seconds..."
                    sleep $wait_time
                    attempt=$((attempt + 1))
                    continue
                else
                    echo "Server error persists after $MAX_RETRIES attempts"
                    return 1
                fi
                ;;
            000)
                echo "🌐 Network Error"
                if [ $attempt -lt $MAX_RETRIES ]; then
                    echo "Connection failed, retrying..."
                    attempt=$((attempt + 1))
                    continue
                else
                    echo "Network error persists"
                    return 1
                fi
                ;;
            *)
                echo "❓ Unexpected Status ($http_code)"
                echo "$response_body"
                return 1
                ;;
        esac
    done
}

# Example usage
echo "Testing SwiftSearch API..."
make_api_request "swiftsearch" '{
    "query": "latest news",
    "max_results": 5
}'