{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "会员开通",
    "method": "POST",
    "path": "/openapi/memberships/activate",
    "description": "基于已支付订单为客户端用户开通会员资格，并自动同步会员用户记录和订单状态。",
    "requestParams": {
      "headers": [
        {
          "name": "Authorization",
          "type": "string",
          "required": true,
          "description": "客户端登录令牌，格式为 Bearer TOKEN"
        }
      ],
      "body": {
        "memberType": "string｜必填，会员类型编码或名称，如 VIP",
        "orderNo": "string｜必填，已支付订单号"
      }
    },
    "responseExample": {
      "success": {
        "code": "0000",
        "message": "会员开通成功",
        "data": {
          "clientUser": {
            "id": "GplqNHbkcmcFa0sj",
            "code": "CU000009",
            "phone": "18347432461",
            "name": "Smkello"
          },
          "memberUser": {
            "id": "toiUHzFoO1xtmSkI",
            "memberType": "VIP"
          },
          "order": {
            "orderNo": "ORD-20250115-0010",
            "status": "COMPLETED"
          }
        }
      },
      "failure": {
        "code": "1107",
        "message": "订单尚未支付或已失效",
        "data": null
      }
    },
    "notes": [
      "该接口会校验黑名单、订单手机号、订单状态与会员类型一致性。",
      "响应 Header X-OpenAPI-Result 存放加密结果用于客户端追踪。"
    ]
  }
}