Skip to content

Get Member Info By VipAppService

Description

透過 VipAppService 查詢會員資料。

Resource

GET /v1/user/member/jxinfo/member_info

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login。

Query Parameters

Name Type Description
shop_id string 店號
input_string string 查詢值,內容依 input_type 決定
input_type string
(enum)
查詢類型
ALLOWED VALUES:
  • PHONE:手機號碼
  • CARD_QRCODE:貴賓 QRCode 卡號
  • CARD_PHYSICAL:實體卡號

Request Example

GET /v1/user/member/jxinfo/member_info?shop_id=0001&input_string=0922373489&input_type=PHONE

Response

{
  "vip_id": "202401TEA0000000006",
  "name": "王小明",
  "card_no": "202401TEA0000000006",
  "mobile": "0922373489",
  "group_name": "一般會員",
  "total_point": 1500.0,
  "sex": "male",
  "level": "金卡",
  "carrier": "/1234ABC",
  "represent_card_no": "1234567890123456",
  "represent_level": 2,
  "stored_value_balance": 350.0
}

Response Body

Name Type Description
vip_id string 會員卡號
name string 會員姓名
card_no string 貴賓卡號
mobile string 手機號碼
group_name string 會員類型名稱
total_point number 總積分
sex Sex 性別
level string 會員級別
carrier string 手機條碼載具
represent_card_no string 代表卡號
(optional) 無此資訊時不回傳
represent_level int 代表等級
(optional) 無此資訊時不回傳
stored_value_balance number 目前儲值金
(optional) 無此資訊時不回傳

Response Body Parameters - Sex

Name Description
male 男
other 其他

Status Codes

Status Code Description
200 查詢成功
404 查無會員資料