Idempotency

curl -X POST "https://api-sandbox.stablesea.com/v1/organizations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000" \
  -d '{
    "name": "Example Organization",
    "contact": {
      "email": "[email protected]",
      "first_name": "John",
      "last_name": "Doe"
    }
  }'

import { v4 as uuidv4 } from "uuid";

// Generate a new key for each unique operation
const idempotencyKey = uuidv4();

// For retries, reuse the same key
const response = await fetch("/api/orders", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + apiKey,
    "Content-Type": "application/json",
    "Idempotency-Key": idempotencyKey,
  },
  body: JSON.stringify(orderData),
});

async function createOrderWithIdempotency(orderData, maxRetries = 3) {
  const idempotencyKey = uuidv4(); // Single key for all retries

  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch("/api/orders", {
        method: "POST",
        headers: {
          Authorization: "Bearer " + apiKey,
          "Idempotency-Key": idempotencyKey,
        },
        body: JSON.stringify(orderData),
      });

      if (response.ok) {
        return await response.json();
      }

      // Don't retry 4xx errors (except 429)
      if (
        response.status >= 400 &&
        response.status < 500 &&
        response.status !== 429
      ) {
        throw new Error(`Client error: ${response.status}`);
      }
    } catch (error) {
      if (attempt === maxRetries) throw error;
      await sleep(1000 * Math.pow(2, attempt - 1)); // Exponential backoff
    }
  }
}