Error Handling

1{
2  "error": "VALIDATION_FAILED",
3  "message": "Die Rechnung entspricht nicht dem XRechnung 3.0.2 Schema"
4}

1{
2  "error": "QUOTA_EXCEEDED",
3  "message": "Usage limit reached for pdf:de:generate",
4  "quota": {
5    "current": 100,
6    "limit": 100,
7    "period": "monthly"
8  }
9}

1async function createInvoice(data, retries = 3) {
2  for (let i = 0; i < retries; i++) {
3    try {
4      const response = await fetch('https://service.invoice-api.xhub.io/api/v1/invoice/de/xrechnung/generate', {
5        method: 'POST',
6        headers: {
7          'Authorization': 'Bearer sk_live_...',
8          'Content-Type': 'application/json'
9        },
10        body: JSON.stringify(data)
11      });
12 
13      if (response.status === 429) {
14        const body = await response.json();
15        // Only the quota rejection carries a `quota` object. Retrying it is
16        // pointless — the monthly allowance is gone until the period rolls over.
17        if (body.quota) throw new Error(body.message);
18        // Rate limit: no Retry-After header is sent, so back off exponentially.
19        await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
20        continue;
21      }
22 
23      if (response.status >= 500) {
24        // Server error - retry with exponential backoff
25        await new Promise(r => setTimeout(r, Math.pow(2, i) * 1000));
26        continue;
27      }
28 
29      const result = await response.json();
30 
31      if (!response.ok) {
32        // Client error - don't retry, handle the error
33        throw new Error(result.message);
34      }
35 
36      return result;
37    } catch (error) {
38      if (i === retries - 1) throw error;
39    }
40  }
41}