Errores

async function callVentry(path, options = {}, attempt = 0) {
  const response = await fetch(`https://api.ventry.es/v1${path}`, {
    ...options,
    headers: { Authorization: `Bearer ${process.env.VENTRY_KEY}`, ...options.headers },
  });

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

  const { error } = await response.json();

  // 429: el servidor dice exactamente cuánto esperar.
  if (response.status === 429 && attempt < 5) {
    const wait = Number(response.headers.get("retry-after") ?? 1) * 1000;
    await new Promise((r) => setTimeout(r, wait));
    return callVentry(path, options, attempt + 1);
  }

  // 5xx: espera creciente. Con Idempotency-Key, reintentar es seguro.
  if (response.status >= 500 && attempt < 3) {
    await new Promise((r) => setTimeout(r, 2 ** attempt * 1000));
    return callVentry(path, options, attempt + 1);
  }

  // El resto son errores tuyos: reintentar da exactamente el mismo resultado.
  throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}

import os, time, requests

BASE = "https://api.ventry.es/v1"

def call_ventry(method, path, attempt=0, **kwargs):
    headers = {
        "Authorization": f"Bearer {os.environ['VENTRY_KEY']}",
        **kwargs.pop("headers", {}),
    }
    response = requests.request(method, f"{BASE}{path}", headers=headers, timeout=30, **kwargs)

    if response.ok:
        return response.json()

    error = response.json()["error"]

    # 429: el servidor dice exactamente cuánto esperar.
    if response.status_code == 429 and attempt < 5:
        time.sleep(int(response.headers.get("retry-after", 1)))
        return call_ventry(method, path, attempt + 1, headers=headers, **kwargs)

    # 5xx: espera creciente. Con Idempotency-Key, reintentar es seguro.
    if response.status_code >= 500 and attempt < 3:
        time.sleep(2 ** attempt)
        return call_ventry(method, path, attempt + 1, headers=headers, **kwargs)

    # El resto son errores tuyos: reintentar da exactamente el mismo resultado.
    raise RuntimeError(f"{error['code']}: {error['message']} ({error['request_id']})")

<?php
function callVentry(string $method, string $path, array $options = [], int $attempt = 0): array
{
    $ch = curl_init("https://api.ventry.es/v1$path");
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HEADER => true,
        CURLOPT_CUSTOMREQUEST => $method,
        CURLOPT_HTTPHEADER => array_merge(
            ["Authorization: Bearer " . getenv("VENTRY_KEY")],
            $options["headers"] ?? []
        ),
    ] + (isset($options["body"]) ? [CURLOPT_POSTFIELDS => $options["body"]] : []));

    $raw = curl_exec($ch);
    $status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    $headerSize = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
    $rawHeaders = substr($raw, 0, $headerSize);
    $body = json_decode(substr($raw, $headerSize), true);
    curl_close($ch);

    if ($status < 400) {
        return $body;
    }

    // 429: el servidor dice exactamente cuánto esperar.
    if ($status === 429 && $attempt < 5) {
        preg_match('/retry-after:\s*(\d+)/i', $rawHeaders, $m);
        sleep((int) ($m[1] ?? 1));
        return callVentry($method, $path, $options, $attempt + 1);
    }

    // 5xx: espera creciente. Con Idempotency-Key, reintentar es seguro.
    if ($status >= 500 && $attempt < 3) {
        sleep(2 ** $attempt);
        return callVentry($method, $path, $options, $attempt + 1);
    }

    // El resto son errores tuyos: reintentar da exactamente el mismo resultado.
    throw new RuntimeException(sprintf(
        "%s: %s (%s)",
        $body["error"]["code"],
        $body["error"]["message"],
        $body["error"]["request_id"]
    ));
}