Production Guide

async function validateWithRetry(xml, apiKey, maxRetries = 3) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const response = await fetch(
      'https://api.invoicenavigator.eu/api/v2/validate-and-fix',
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${apiKey}`,
          'Content-Type': 'application/json',
        },
        body: JSON.stringify({ xml }),
      }
    );

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

    // Don't retry client errors (except rate limits)
    if (response.status >= 400 && response.status < 500
        && response.status !== 429) {
      const body = await response.json();
      throw new Error(`Client error ${response.status}: ${body.error.message}`);
    }

    if (attempt === maxRetries) {
      throw new Error(`Failed after ${maxRetries + 1} attempts`);
    }

    // Use Retry-After header if present, otherwise exponential backoff
    const retryAfter = response.headers.get('Retry-After');
    const delay = retryAfter
      ? parseInt(retryAfter) * 1000
      : Math.min(1000 * Math.pow(2, attempt), 10000)
        + Math.random() * 500;

    await new Promise(resolve => setTimeout(resolve, delay));
  }
}

import requests
import time
import random

def validate_with_retry(xml: str, api_key: str, max_retries: int = 3):
    for attempt in range(max_retries + 1):
        response = requests.post(
            "https://api.invoicenavigator.eu/api/v2/validate-and-fix",
            headers={"Authorization": f"Bearer {api_key}"},
            json={"xml": xml},
        )

        if response.ok:
            return response.json()

        # Don't retry client errors (except rate limits)
        if 400 <= response.status_code < 500 and response.status_code != 429:
            raise Exception(
                f"Client error {response.status_code}: "
                f"{response.json()['error']['message']}"
            )

        if attempt == max_retries:
            raise Exception(f"Failed after {max_retries + 1} attempts")

        # Use Retry-After header if present, otherwise exponential backoff
        retry_after = response.headers.get("Retry-After")
        if retry_after:
            delay = int(retry_after)
        else:
            delay = min(2 ** attempt, 10) + random.uniform(0, 0.5)

        time.sleep(delay)