Errors

# Пример валидационной ошибки (422)
curl -X POST https://fin-os.io/api/v1/customers \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{"phone": "not-a-phone"}'

# HTTP/2 422
# {
#   "message": "The given data was invalid.",
#   "errors": {
#     "phone": ["The phone must be a valid E.164 number."]
#   },
#   "error_code": "VALIDATION_FAILED",
#   "request_id": "5f8d7a3c-1234-4567-89ab-cdef01234567"
# }

// Унифицированный обработчик
async function apiCall(url, init = {}) {
  const res = await fetch(url, {
    ...init,
    headers: { 'Accept': 'application/json', ...init.headers },
  });

  if (res.ok) return res.json();

  const err = await res.json().catch(() => ({ message: 'Network error' }));

  switch (err.error_code) {
    case 'TOKEN_INVALID':
      throw new Error('API-ключ невалиден - обновите секрет в конфигурации сервиса');
    case 'INSUFFICIENT_BALANCE':
      throw new Error('Недостаточно средств');
    default:
      throw new Error(err.message || `HTTP ${res.status}`);
  }
}

try {
    $response = Http::withToken($token)
        ->throw()
        ->post('https://fin-os.io/api/v1/customers/' . $uuid . '/wallet/withdraw', $data);
} catch (\Illuminate\Http\Client\RequestException $e) {
    $body = $e->response->json();
    $code = $body['error_code'] ?? null;

    match ($code) {
        'INSUFFICIENT_BALANCE' => throw new InsufficientBalanceException($body['message']),
        'KYC_REQUIRED'         => throw new KycRequiredException($body['message']),
        'SANCTION_HIT'         => logger()->alert('Sanction hit', ['request_id' => $body['request_id'] ?? null]),
        default                => throw $e,
    };
}

import requests

class FinanceOsError(Exception):
    def __init__(self, code, message, request_id=None):
        self.code = code
        self.message = message
        self.request_id = request_id
        super().__init__(f'{code}: {message}')

def api_call(method, url, **kwargs):
    r = requests.request(method, url, **kwargs)
    if r.ok:
        return r.json()
    body = r.json() if 'application/json' in r.headers.get('Content-Type', '') else {}
    raise FinanceOsError(
        code=body.get('error_code', f'HTTP_{r.status_code}'),
        message=body.get('message', 'Unknown error'),
        request_id=body.get('request_id'),
    )

try:
    balance = api_call('GET', 'https://fin-os.io/api/v1/merchant/balance',
                       headers={'Authorization': f'Bearer {TOKEN}'})
except FinanceOsError as e:
    if e.code == 'TOKEN_INVALID':
        print('Ключ невалиден - обновите секрет')
    else:
        print(f'API error: {e.code} ({e.request_id})')