Body Measurement API

{
  "status": "accepted",
  "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

// JavaScript
const { task_id } = await korra.extract({
  front: frontBlob,       // File, Blob, or Buffer
  side: sideBlob,
  height: 175,            // cm
  gender: 'male',         // "male" | "female"
  client_name: 'John',    // optional
});

# Python
result = client.measurements.extract(
    front="front.jpg",    # file path, file object, or bytes
    side="side.jpg",
    height=175,
    gender="male",
    client_name="John",   # optional
)

// JavaScript — automatic polling
const result = await korra.waitForCompletion(task_id, {
  onStatus: (s) => console.log(s.status),  // optional callback
  pollIntervalMs: 2000,                     // initial interval
  maxAttempts: 30,                          // max polls
});

# Python — automatic polling
final = client.measurements.wait_for_completion(
    task_id,
    on_status=lambda s: print(s["status"]),
    poll_interval=2.0,
    max_attempts=30,
)

// JavaScript — manual polling
let status;
do {
  status = await korra.status(task_id);
  if (status.status === 'failed') throw new Error(status.error);
  if (status.status !== 'completed') await sleep(3000);
} while (status.status !== 'completed');

console.log(status.measurements);

// JavaScript
const { task_id } = await korra.extractWidget({
  front: frontBlob,
  side: sideBlob,
  height: 165,
  gender: 'female',
  merchant_id: 'my-merchant-uuid',
  payment_reference: 'pay_ref_xxx',  // optional: pay-per-scan
});

# Python
result = client.measurements.extract_widget(
    front="front.jpg",
    side="side.jpg",
    height=165,
    merchant_id="my-merchant-uuid",
    payment_reference="pay_ref_xxx",
)

{
  "status": "success",
  "estimation_mode": "height_only",
  "measurements": {
    "chest": 89.3,
    "waist": 73.5,
    "hip": 93.1,
    "shoulder": 77.0,
    "inseam": 91.0,
    "outseam": 129.5,
    "sleeve": 66.5,
    "neck": 35.0,
    "bicep": 28.0,
    "wrist": 17.5,
    "thigh": 54.3,
    "calf": 35.0,
    "ankle": 22.8
  },
  "body_shape": "Hourglass",
  "size_recommendation": "M",
  "confidence": "estimated",
  "note": "Estimates based on standard anthropometric ratios."
}

// JavaScript
const estimate = await korra.estimate({ height: 175, gender: 'male' });
console.log(estimate.measurements.chest);  // ~95.2

# Python
estimate = client.measurements.estimate(height=175, gender="male")
print(estimate["measurements"]["chest"])

{
  "key": "korra_live_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tier": "tailor_pro",
  "created": true
}

// JavaScript
const { key, tier, created } = await korra.provisionKey({
  jwt: 'eyJhbGciOiJIUzI1NiIs...',
  regenerate: false,
});

# Python
result = client.measurements.provision_key(
    jwt="eyJhbGciOiJIUzI1NiIs...",
    regenerate=False,
)

// JavaScript
const list = await korra.measurements.list({ limit: 20, offset: 0 });

# Python
list = client.measurements.list(limit=20, offset=0)

{
  "detail": "Insufficient credits for extraction."
}

// JavaScript
import Korra, { InsufficientCreditsError, AuthenticationError } from '@korra/sdk';

try {
  await korra.extract({ ... });
} catch (e) {
  if (e instanceof InsufficientCreditsError) {
    // Redirect to billing
  } else if (e instanceof AuthenticationError) {
    // Re-authenticate
  }
}

# Python
from aiscan.exceptions import InsufficientCreditsError, AuthenticationError

try:
    client.measurements.extract(...)
except InsufficientCreditsError:
    # Redirect to billing
except AuthenticationError:
    # Re-authenticate