getCartByKeys

按商品 key 三元组批量查价（该分组下唯一 POST 接口）。前端从 localStorage 取购物项的 key 三元组 + area/language，后端按 (area, language) 返回每行的实时套餐价 / 库存 + 商品名 / 图。

属性	值
方法	POST
路径	/config/getCartByKeys
鉴权	公开
Content-Type	application/json

请求体

{
  "area": "us",
  "language": "en",
  "items": [
    { "sortKey": "rings", "productKey": "solitaire", "comboKey": "0.5ct-gold" }
  ]
}

字段	类型	必填	说明
area	string	否	地区代码
language	string	否	语言代码
items	array	是	购物项数组
items[].sortKey	string	是	分类 key
items[].productKey	string	是	商品 key
items[].comboKey	string	是	套餐 key

响应

{
  "code": 0,
  "message": "",
  "data": {
    "list": [
      {
        "id": 0,
        "comboName": "",
        "comboKey": "",
        "name": "",
        "image": "",
        "sortKey": "",
        "productKey": "",
        "areaInfo": {}
      }
    ]
  }
}

:::note area 兜底 getCartByKeys 内部按 area → default → us 命中价格行。新站价格表常只有 default 行，此前该接口曾漏 default 兜底导致加购后购物车恒空。 :::

示例

curl -s -X POST 'https://service.boldsaasify.com/config/getCartByKeys' \
  -H 'Content-Type: application/json' \
  -H 'X-Site-Domain: boldradiant.com' \
  -d '{"area":"us","language":"en","items":[{"sortKey":"rings","productKey":"solitaire","comboKey":"0.5ct-gold"}]}'