Error Handling

async function stileRequest(method, path, body) {
  const res = await fetch(`https://api.stile.id/v1${path}`, {
    method,
    headers: {
      Authorization: `Bearer ${process.env.STILE_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: body ? JSON.stringify(body) : undefined,
  });

  const data = await res.json();

  if (!res.ok) {
    const err = data.error ?? {};
    switch (err.type ?? "api_error") {
      case "authentication_error":
        throw new Error(`Auth failed: ${err.message}`);
      case "rate_limit_error":
        throw new Error(`Rate limited. Retry after ${res.headers.get("Retry-After")}s`);
      case "invalid_request_error":
        throw new Error(`Bad request [${err.code ?? "unknown"}]: ${err.message}`);
      default:
        throw new Error(`API error: ${err.message ?? "Request failed"} (${err.request_id ?? "no request id"})`);
    }
  }

  return data;
}

import requests, os

def stile_request(method, path, json=None):
    res = requests.request(
        method,
        f"https://api.stile.id/v1{path}",
        headers={"Authorization": f"Bearer {os.environ['STILE_API_KEY']}"},
        json=json,
    )

    data = res.json()

    if not res.ok:
        err = data.get("error", {})
        if err.get("type") == "authentication_error":
            raise Exception(f"Auth failed: {err['message']}")
        elif err.get("type") == "rate_limit_error":
            raise Exception(f"Rate limited. Retry after {res.headers.get('Retry-After')}s")
        elif err.get("type") == "invalid_request_error":
            raise Exception(f"Bad request [{err.get('code', 'unknown')}]: {err.get('message', 'Request failed')}")
        else:
            raise Exception(f"API error: {err.get('message', 'Request failed')} ({err.get('request_id', 'no request id')})")

    return data

type StileError struct {
    Type      string `json:"type"`
    Code      string `json:"code"`
    Message   string `json:"message"`
    Param     string `json:"param"`
    RequestID string `json:"request_id"`
    Status    int
}

func (e *StileError) Error() string {
    return fmt.Sprintf("[%s] %s: %s (request_id: %s)",
        e.Type, e.Code, e.Message, e.RequestID)
}

func stileRequest(method, path string, body io.Reader) ([]byte, error) {
    req, _ := http.NewRequest(method, "https://api.stile.id/v1"+path, body)
    req.Header.Set("Authorization", "Bearer "+os.Getenv("STILE_API_KEY"))
    req.Header.Set("Content-Type", "application/json")

    res, err := http.DefaultClient.Do(req)
    if err != nil {
        return nil, err
    }
    defer res.Body.Close()
    data, _ := io.ReadAll(res.Body)

    if res.StatusCode >= 400 {
        var errResp struct{ Error StileError `json:"error"` }
        json.Unmarshal(data, &errResp)
        errResp.Error.Status = res.StatusCode
        return nil, &errResp.Error
    }

    return data, nil
}

require "net/http"
require "json"

class StileError < StandardError
  attr_reader :type, :code, :param, :request_id, :status

  def initialize(err, status)
    @type = err["type"]
    @code = err["code"]
    @param = err["param"]
    @request_id = err["request_id"]
    @status = status
    super(err["message"])
  end
end

def stile_request(method, path, body = nil)
  uri = URI("https://api.stile.id/v1#{path}")
  req = Net::HTTP.const_get(method.capitalize).new(uri)
  req["Authorization"] = "Bearer #{ENV['STILE_API_KEY']}"
  req["Content-Type"] = "application/json"
  req.body = body.to_json if body

  res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
  data = JSON.parse(res.body)

  raise StileError.new(data["error"], res.code.to_i) unless res.is_a?(Net::HTTPSuccess)

  data
end

class StileError extends Exception {
    public ?string $type;
    public ?string $code;
    public ?string $param;
    public ?string $requestId;
    public int $status;

    public function __construct(array $err, int $status) {
        $this->type = $err["type"] ?? null;
        $this->code = $err["code"] ?? null;
        $this->param = $err["param"] ?? null;
        $this->requestId = $err["request_id"] ?? null;
        $this->status = $status;
        parent::__construct($err["message"]);
    }
}

function stileRequest(string $method, string $path, ?array $body = null): array {
    $ch = curl_init("https://api.stile.id/v1{$path}");
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        "Authorization: Bearer " . getenv("STILE_API_KEY"),
        "Content-Type: application/json",
    ]);
    if ($body) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));

    $response = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    $data = json_decode($response, true);

    if ($status >= 400) {
        throw new StileError($data["error"], $status);
    }

    return $data;
}

async function stileRequestWithRetry(method, path, body, maxRetries = 2) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = await fetch(`https://api.stile.id/v1${path}`, {
      method,
      headers: {
        Authorization: `Bearer ${process.env.STILE_API_KEY}`,
        "Content-Type": "application/json",
      },
      body: body ? JSON.stringify(body) : undefined,
    });

    if (res.status === 429 || res.status >= 500) {
      if (attempt < maxRetries) {
        const retryAfterHeader = res.headers.get("Retry-After");
        const retryAfter = retryAfterHeader === null ? null : Number(retryAfterHeader);
        const delay = res.status === 429 && retryAfter !== null && Number.isFinite(retryAfter)
          ? retryAfter * 1000
          : Math.min(500 * 2 ** attempt + Math.random() * 500, 30000);
        await new Promise((r) => setTimeout(r, delay));
        continue;
      }
    }

    const data = await res.json();
    if (!res.ok) throw new Error(data.error.message);
    return data;
  }
}

import time, random

def stile_request_with_retry(method, path, json=None, max_retries=2):
    for attempt in range(max_retries + 1):
        res = requests.request(
            method,
            f"https://api.stile.id/v1{path}",
            headers={"Authorization": f"Bearer {os.environ['STILE_API_KEY']}"},
            json=json,
        )

        if res.status_code in (429, 500, 502, 503, 504):
            if attempt < max_retries:
                delay = min(0.5 * 2**attempt + random.random() * 0.5, 30)
                time.sleep(delay)
                continue

        data = res.json()
        if not res.ok:
            raise Exception(data["error"]["message"])
        return data

func stileRequestWithRetry(method, path string, body []byte, maxRetries int) ([]byte, error) {
    for attempt := 0; attempt <= maxRetries; attempt++ {
        // Create a fresh reader on every attempt; an io.Reader is consumed by the first request.
        data, err := stileRequest(method, path, bytes.NewReader(body))

        if stileErr, ok := err.(*StileError); ok {
            if stileErr.Status == 429 || stileErr.Status >= 500 {
                if attempt < maxRetries {
                    delay := math.Min(500*math.Pow(2, float64(attempt))+rand.Float64()*500, 30000)
                    time.Sleep(time.Duration(delay) * time.Millisecond)
                    continue
                }
            }
        }

        return data, err
    }
    return nil, fmt.Errorf("max retries exceeded")
}

def stile_request_with_retry(method, path, body = nil, max_retries: 2)
  (0..max_retries).each do |attempt|
    begin
      return stile_request(method, path, body)
    rescue StileError => e
      raise unless [429, 500, 502, 503, 504].include?(e.status)
      raise if attempt >= max_retries

      delay = [0.5 * 2**attempt + rand * 0.5, 30].min
      sleep(delay)
    end
  end
end

function stileRequestWithRetry(string $method, string $path, ?array $body = null, int $maxRetries = 2): array {
    for ($attempt = 0; $attempt <= $maxRetries; $attempt++) {
        try {
            return stileRequest($method, $path, $body);
        } catch (StileError $e) {
            if (!in_array($e->status, [429, 500, 502, 503, 504]) || $attempt >= $maxRetries) {
                throw $e;
            }
            $delay = min(0.5 * pow(2, $attempt) + lcg_value() * 0.5, 30);
            usleep((int)($delay * 1_000_000));
        }
    }
}

curl -X POST https://api.stile.id/v1/verification_sessions \
  -H "Authorization: Bearer stile_sk_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order_12345" \
  -d '{"type": "age", "workflow_id": "wf_YOUR_WORKFLOW_ID"}'

const session = await stile.verificationSessions.create(
  { type: "age", workflow_id: "wf_YOUR_WORKFLOW_ID" },
  { idempotencyKey: "order_12345" },
);