Internationalization

# Request valuations in a specific currency
curl "https://api.justkalm.com/v2/valuate" \
  -H "Authorization: Bearer jk_live_xxx" \
  -H "Accept-Currency: EUR" \
  -d '{"url": "https://example.com/product"}'

# Response with converted prices
{
  "id": "val_K7j9mNpQ",
  "price_min": 1350,
  "price_max": 1720,
  "currency": "EUR",
  "exchange_rate": {
    "from": "USD",
    "to": "EUR",
    "rate": 0.93,
    "timestamp": "2024-01-15T10:00:00Z"
  }
}

# Request localized formatting
curl "https://api.justkalm.com/v2/valuate" \
  -H "Authorization: Bearer jk_live_xxx" \
  -H "Accept-Language: de-DE" \
  -H "Accept-Currency: EUR" \
  -d '{"url": "https://example.com/product"}'

# Response with localized formatting
{
  "id": "val_K7j9mNpQ",
  "price_min": 1350,
  "price_max": 1720,
  "formatted": {
    "price_range": "1.350,00 € – 1.720,00 €",
    "created_at": "15. Januar 2024, 10:30"
  }
}

import { JustKalm } from '@justkalm/sdk';

const client = new JustKalm({
  apiKey: 'jk_live_xxx',
  // Set default currency and locale
  currency: 'EUR',
  locale: 'de-DE',
});

const valuation = await client.valuate('https://example.com/product');

console.log(valuation.formatted.priceRange); // "1.350,00 € – 1.720,00 €"
console.log(valuation.formatted.createdAt);  // "15. Januar 2024"

// Override per-request
const jpValuation = await client.valuate(url, {
  currency: 'JPY',
  locale: 'ja-JP',
});

# Get available currencies by region
curl "https://api.justkalm.com/v2/currencies" \
  -H "Authorization: Bearer jk_live_xxx"

# Response
{
  "currencies": [
    {
      "code": "USD",
      "symbol": "$",
      "name": "US Dollar",
      "regions": ["US", "EC", "PA", "SV"],
      "decimal_places": 2
    },
    {
      "code": "EUR",
      "symbol": "€",
      "name": "Euro",
      "regions": ["DE", "FR", "IT", "ES", "NL", ...],
      "decimal_places": 2
    }
  ]
}