Errors

class VNSwitchError extends Error {
  constructor(status, body) {
    const err = body?.error ?? {};
    super(`${status} ${err.code ?? "unknown"}: ${err.message ?? "no error body"}`);
    this.status = status;
    this.code = err.code;
    this.type = err.type ?? err.error_type;
    this.body = body;
  }
}

async function callVNSwitch(path, options = {}) {
  const res = await fetch(`https://sandbox.api.vnswitch.nivc.ai${path}`, {
    ...options,
    headers: {
      "Content-Type": "application/json",
      "api-key": process.env.VNSWITCH_API_KEY,
      ...options.headers,
    },
  });
  const body = await res.json().catch(() => null);
  // Check for an error object even on 2xx: a few checks answer 200 with an error body.
  if (!res.ok || body?.error) throw new VNSwitchError(res.status, body);
  return body;
}

try {
  console.log(await callVNSwitch("/payments/pay_does_not_exist"));
} catch (e) {
  if (!(e instanceof VNSwitchError)) throw e; // network error or timeout
  console.log(e.status, e.code, e.message); // 404 HE_02 ...
}

import os

import requests

class VNSwitchError(Exception):
    def __init__(self, status, body):
        err = (body or {}).get("error", {})
        super().__init__(f"{status} {err.get('code')}: {err.get('message')}")
        self.status = status
        self.code = err.get("code")
        self.type = err.get("type", err.get("error_type"))
        self.body = body

def call_vnswitch(method, path, **kwargs):
    resp = requests.request(
        method,
        f"https://sandbox.api.vnswitch.nivc.ai{path}",
        headers={"api-key": os.environ["VNSWITCH_API_KEY"]},
        timeout=30,
        **kwargs,
    )
    try:
        body = resp.json()
    except ValueError:
        body = None
    # Check for an error object even on 2xx: a few checks answer 200 with an error body.
    if not resp.ok or (isinstance(body, dict) and "error" in body):
        raise VNSwitchError(resp.status_code, body)
    return body

try:
    print(call_vnswitch("GET", "/payments/pay_does_not_exist"))
except VNSwitchError as e:
    print(e.status, e.code, e)  # 404 HE_02 ...

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class ErrorHandling {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://sandbox.api.vnswitch.nivc.ai/payments/pay_does_not_exist"))
            .header("api-key", System.getenv("VNSWITCH_API_KEY"))
            .timeout(Duration.ofSeconds(30))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        int status = response.statusCode();
        // Parse the body with your JSON library and read error.code and error.message.
        // Check for an "error" object even on 2xx.
        boolean failed = status >= 300 || response.body().contains("\"error\":");
        if (failed) {
            System.out.println("VNSwitch error, HTTP " + status + ": " + response.body());
        } else {
            System.out.println(response.body());
        }
    }
}