Bowmark AIdocs

Ritani

Ritani's real Ring Studio custom-engagement-ring configurator — read the live option catalog (diamond shape, head/setting style, metal, band style and…

Ritani's real Ring Studio custom-engagement-ring configurator — read the live option catalog (diamond shape, head/setting style, metal, band style and metal) and price an exact build against Ritani's own live pricing engine rather than a researched estimate.

Domain: ritani.com

Also known as: Ritani, ritani, Ritani Inc, ritani.com

Call it directly

bowmark.providers.ritani.getConfigurator(): Promise<RitaniConfigurator>
bowmark.providers.ritani.priceConfiguration(selections: RitaniSelections): Promise<RitaniPriceResult>

Functions

FunctionWhat it does
getConfiguratorReads Ritani's real live Ring Studio option catalog: every center stone shape, head/setting style (grouped, e.g. 4-Prong/Halo/Vintage), head metal, shank (band) style and shank metal, plus…
priceConfigurationPrices one exact custom-ring build against Ritani's own live Ring Studio pricing engine ('/api/custom-ring') and returns the real total, compare-at price, and a matching band's own price —…

Types

// Ritani's OWN shapes — not a capability contract.

interface RitaniOption {
  name: string;   // the site's own option code, e.g. "round" | "104" | "head-14kt-white-gold"
  title: string;  // e.g. "Round" | "Four Prong" | "14kt White Gold"
  icon: string;
  group: string | null;  // e.g. "4-Prong" | "Halo" | "Vintage", for head/shank styles
  disabled: boolean;      // true for a currently-unavailable option, still listed
}

interface RitaniConfigurator {
  centerStoneShapes: RitaniOption[];
  headStyles: RitaniOption[];
  headMetals: RitaniOption[];
  shankStyles: RitaniOption[];   // the band/setting style
  shankMetals: RitaniOption[];
  startingPrice: number;  // the default build's own price ("Starting at" on the site)
}

interface RitaniSelections {
  centerStoneShape: string;  // required — a RitaniOption.name from centerStoneShapes
  headStyle: string;         // required — from headStyles
  headMetal: string;         // required — from headMetals
  shankStyle?: string;       // omit for the head-only build (no band)
  shankMetal?: string;
  ringSize?: string;
}

interface RitaniPriceResult {
  title: string;
  sku: string;
  price: number;          // the real total for this exact build
  compareAtPrice: number;
  bandPrice: number;       // a plain matching band's own price, quoted alongside
  selections: {            // echoes back what Ritani's engine actually priced
    centerStoneShape: string;
    headStyle: string;
    headMetal: string;
    shankStyle: string;
    shankMetal: string;
  };
}