Inventory and variations

# Use a new Idempotency-Key for each write, and the same one to retry it.
# Set KEY to the same value to retry this write.
KEY=${KEY:-inventory-$(date +%s)-$RANDOM}
# A 202 answers the change ("object": "workspace.change") with a Location to poll: don't send the write again.
curl -i --fail-with-body -sS -X PATCH https://api.alura.io/v1/workspace/listings/1834720561/inventory \
  -H "Authorization: Bearer $ALURA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d '{"offerings": [{"select": {"Primary color": "Black"}, "price": "21.00"}]}'

interface Inventory {
  products: { id: string; sku: string | null; property_values: { values: string[] }[]; offerings: { price: { amount: string } | null; quantity: number | null }[] }[] | null;
  change: { id: string; status: string };
}

// One key per write: keep it to retry this write, and the retry answers from the first write instead of writing again.
const idempotencyKey = crypto.randomUUID();
const res = await fetch('https://api.alura.io/v1/workspace/listings/1834720561/inventory', {
  method: 'PATCH',
  headers: { Authorization: `Bearer ${process.env.ALURA_API_KEY}`, 'Content-Type': 'application/json', 'Idempotency-Key': idempotencyKey },
  body: JSON.stringify({ offerings: [{ select: { 'Primary color': 'Black' }, price: '21.00' }] }),
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
if (res.status === 202) {
  // Etsy is still answering: the body is the change. Poll it until its outcome is known; don't send the write again.
  const change = (await res.json()) as { id: string; outcome: string };
  console.log(`change ${change.id} ${change.outcome}: poll ${res.headers.get('Location')}`);
} else {
  const inventory = (await res.json()) as Inventory;
  // Etsy issued new product IDs on this write: select variants by their values, never by these IDs.
  for (const product of inventory.products ?? []) {
    const offering = product.offerings[0];
    console.log(`${product.property_values.map((v) => v.values[0]).join('/')} ${product.sku}: ${offering?.price?.amount ?? 'unknown'} x ${offering?.quantity ?? 'unknown'}`);
  }
  console.log(`change ${inventory.change.id} ${inventory.change.status}`);
}

import json
import os
import urllib.request
import uuid

# One key per write: keep it to retry this write, and the retry answers from the first write instead of writing again.
idempotency_key = str(uuid.uuid4())
body = {"offerings": [{"select": {"Primary color": "Black"}, "price": "21.00"}]}
request = urllib.request.Request(
    "https://api.alura.io/v1/workspace/listings/1834720561/inventory",
    data=json.dumps(body).encode(),
    method="PATCH",
    headers={
        "Authorization": f"Bearer {os.environ['ALURA_API_KEY']}",
        "Content-Type": "application/json",
        "Idempotency-Key": idempotency_key,
    },
)
with urllib.request.urlopen(request) as response:
    status = response.status
    location = response.headers.get("Location")
    answer = json.load(response)

if status == 202:
    # Etsy is still answering: the body is the change. Poll it until its outcome is known; don't send the write again.
    print(f"change {answer['id']} {answer['outcome']}: poll {location}")
else:
    # Etsy issued new product IDs on this write: select variants by their values, never by these IDs.
    for product in answer["products"] or []:
        offering = product["offerings"][0] if product["offerings"] else None
        price = offering["price"]["amount"] if offering and offering["price"] else "unknown"
        quantity = offering["quantity"] if offering and offering["quantity"] is not None else "unknown"
        values = "/".join(v["values"][0] for v in product["property_values"])
        print(f"{values} {product['sku']}: {price} x {quantity}")
    print(f"change {answer['change']['id']} {answer['change']['status']}")