Troubleshooting Guide

# Correct format
curl -H "Authorization: upw_live_1234567890abcdef" https://api.upwell.com/api/rest/invoices

From: your-email@company.com
To: invoices@yourdomain.upwell.com
Subject: [Invoice] or [Bill]

curl -X GET "https://api.upwell.com/api/rest/shipments" \
  -H "Authorization: YOUR_API_KEY"

// Use pagination for large datasets
const response = await fetch(
  'https://api.upwell.com/api/rest/invoices?limit=50&offset=0'
);

// Filter by date range to reduce data volume
const params = new URLSearchParams({
  'created_after': '2024-01-01',
  'created_before': '2024-01-31',
  'status': 'pending'
});

// Process multiple items in a single request
const bulkUpdate = await fetch(
  'https://api.upwell.com/api/rest/bulk-invoices',
  {
    method: 'PUT',
    body: JSON.stringify({ invoices: invoiceArray })
  }
);

import time
import random

def api_call_with_backoff(url, max_retries=5):
    for attempt in range(max_retries):
        response = requests.get(url)

        if response.status_code == 429:
            wait_time = (2 ** attempt) + random.uniform(0, 1)
            time.sleep(wait_time)
            continue

        return response

def check_rate_limit(response):
    remaining = int(response.headers.get('X-RateLimit-Remaining', 0))
    reset_time = int(response.headers.get('X-RateLimit-Reset', 0))

    if remaining < 10:
        current_time = time.time()
        sleep_time = reset_time - current_time
        if sleep_time > 0:
            time.sleep(sleep_time)

const requiredFields = ['customer_id', 'amount', 'due_date'];
const missingFields = requiredFields.filter(field => !invoiceData[field]);

if (missingFields.length > 0) {
  throw new Error(`Missing required fields: ${missingFields.join(', ')}`);
}

def validate_invoice_data(data):
    if not isinstance(data.get('amount'), (int, float)) or data['amount'] <= 0:
        raise ValueError("Amount must be a positive number")

    if not re.match(r'^\d{4}-\d{2}-\d{2}$', data.get('due_date', '')):
        raise ValueError("Due date must be in YYYY-MM-DD format")

# Search instead of direct lookup
curl "https://api.upwell.com/api/rest/invoices/search?number=INV-001" \
  -H "Authorization: YOUR_API_KEY"