Códigos de erro

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Erro de validação nos dados fornecidos",
    "details": [
      {
        "field": "amount",
        "message": "O valor deve ser maior que zero"
      }
    ]
  }
}

import { UpayClient, UpayValidationError, UpayAuthenticationError } from '@upay/upay-js';

const upay = new UpayClient({ apiKey: 'sua_api_key' });

try {
  const link = await upay.paymentLinks.create({
    title: 'Produto',
    amount: 10000,
  });
} catch (error) {
  if (error instanceof UpayValidationError) {
    console.error('Erro de validação:', error.message);
    console.error('Detalhes:', error.details);
  } else if (error instanceof UpayAuthenticationError) {
    console.error('Erro de autenticação:', error.message);
  } else {
    console.error('Erro desconhecido:', error);
  }
}

from upay import UpayClient, UpayValidationError, UpayAuthenticationError

upay = UpayClient(api_key="sua_api_key")

try:
    link = upay.payment_links.create({
        "title": "Produto",
        "amount": 10000
    })
except UpayValidationError as e:
    print(f"Erro de validação: {e.message}")
    print(f"Detalhes: {e.details}")
except UpayAuthenticationError as e:
    print(f"Erro de autenticação: {e.message}")
except Exception as e:
    print(f"Erro desconhecido: {e}")

use Upay\UpayClient;
use Upay\Utils\Exceptions\UpayValidationError;
use Upay\Utils\Exceptions\UpayAuthenticationError;

$upay = new UpayClient(apiKey: "sua_api_key");

try {
    $link = $upay->paymentLinks->create([
        'title' => 'Produto',
        'amount' => 10000
    ]);
} catch (UpayValidationError $e) {
    echo "Erro de validação: " . $e->getMessage() . "\n";
    print_r($e->details);
} catch (UpayAuthenticationError $e) {
    echo "Erro de autenticação: " . $e->getMessage() . "\n";
} catch (Exception $e) {
    echo "Erro desconhecido: " . $e->getMessage() . "\n";
}

# Exemplo de resposta de erro
curl -X POST https://upay-sistema-api.onrender.com/api/v1/payment-links \
  -H "Authorization: Bearer sua_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Produto",
    "amount": -100
  }'

# Resposta (400 Bad Request):
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Erro de validação nos dados fornecidos",
    "details": [
      {
        "field": "amount",
        "message": "O valor deve ser maior que zero"
      }
    ]
  }
}

async function retryWithBackoff(fn: () => Promise<any>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (error) {
      if (error.status >= 500 || error.status === 429) {
        const delay = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise(resolve => setTimeout(resolve, delay));
      } else {
        throw error;
      }
    }
  }
  throw new Error('Max retries exceeded');
}

const response = await fetch('https://upay-sistema-api.onrender.com/api/v1/payment-links', {
  headers: { 'Authorization': `Bearer ${apiKey}` }
});

const remaining = response.headers.get('X-RateLimit-Remaining');
const reset = response.headers.get('X-RateLimit-Reset');

if (remaining < 10) {
  console.warn('Próximo do limite de rate limit');
}

catch (error) {
  console.error({
    timestamp: new Date().toISOString(),
    errorCode: error.code,
    message: error.message,
    details: error.details,
    requestId: error.requestId, // Se disponível
  });
}

function validatePaymentLink(data: any) {
  if (!data.title || data.title.length < 3) {
    throw new Error('Título deve ter pelo menos 3 caracteres');
  }
  if (!data.amount || data.amount <= 0) {
    throw new Error('Valor deve ser maior que zero');
  }
  // ... outras validações
}