Skip to content

Get Member Data With VIP ID

Description

透過 vip_id 取得會員資料。

Resource

GET /v1/member_data_with_vip_id

Authorization

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

Query Parameters

Name Type Description
vip_id string 會員編號

Request Example

GET /v1/member_data_with_vip_id?vip_id=12345678

Response

{
  "data": "zZnIDLu9Xfls77boiMpW0Cq/BbfzrOEtGb8XJwvqLEUs2o5FMns2xvY3DR9RlawiV9b4alyS0LpG6aYnA2guUijYqT39muGCOcWCkCcsr7LTs30qUNUK+wZQkvvQQhLq1QBBOiWJoeSyAr79o3L4F+McdFdj1C+LyliWdeP623exe/sOClC6JcBks+XG6sr2VEl11fQKUqol6FjK+ZxiD10p8Vy+4z7JRTWZRQhSHoV2+2jZ7CSj1OmnNMxH1GRhbWhLRomE6SjqDBYyAyXWNfsg96u0DMmmLUbBb54T3yM0IPabvXfxT7zBErLKNXA0F8Ueo/MZj3jh+sggnz21YrFJtNPWHEBL7/6mhtZ3ecwWmkwAZ2scarTd4ik10vkCWrn7J7+2az37NNmuElHllt++oC1z/doSlZv1erMqQcy7FVYwRNyp1wFAP++q66uuzaQlhxuzGa1FrBdrLdtEJpYfkvGNB8TJhdm0jyTbv7IRn+B53PObKEg4Ul2CrFm6BtKaBGRLDgA6TLlGHxP6VyNCyIqwzghszxhrYDZ57x2sPeL20d/TGCkmnsqDLTfDOpXuh01uLaGs4TRNUKvrKT4IVbv1vdK0pxtzQP09daDM4dJXuGIp/arUsE1Me+4ba3LBDmgRdbbCZ/ON15y8+cam3bNfdIxGFA1HUinqBAa25+Wyj6mRV7TAHtCR5MPt8YjPtBYkl8m43DsWjwsdOOMWjFmJBrq/nx92QE08FaJhY03e/mvnuYlZrk/w7FypXNx2me4z2ETb8sc7HdD8wWZ+tzYZ5f8shY9YOnxXS1uEuyIw1Q14C75f+mgOALF7vC/bXVAqHH3SaCnohJnuhfCp5ZJTxTPAZdH/tGS0cNuUJZ06xd2WxChFb8NXrPZDyWlnHkeei0wiyiJdfwRtALU+K8ZZIHdG1VOhHPvlKwQNplO330oswjBhj3V6XQTmQS4evN8TMOJMUAxJX18FA67+YbEmI2kJI/aZ0zXXKXiRFWqM1K4vWYUp8aR5ejd/UaNAEX0BmRwfF5588hTvHAeJ5do9b29gzSyEdXQz27PF4WI2W/cxXTFbeB83zz5P",
  "iv": "cHJlZml4MDAyMDI1MTEyNQ==",
  "mac": "b712a07a389bd34c6379194cf390b6209a0679599aec69dbea054afe2435a19c"
}

Response Body

Name Type Description
data string 加密後的會員資料 (Base64 Encoded)
iv string 初始向量 (Base64 Encoded)
mac string 訊息認證碼 (HMAC-SHA256)

Encryption Details

Encryption Method

  • Algorithm: AES-256-CBC
  • Key: 32 bytes (256 bits)
  • IV: 16 bytes (128 bits)
  • Padding: PKCS7

MAC Generation

  • Algorithm: HMAC-SHA256
  • Key: Same key as used for encryption.
  • Input: iv (bytes) + encrypted_data (bytes)
  • Output: Hex digest string

Decrypted Data Structure

解密 data 欄位後,將獲得以下 JSON 格式的會員詳細資料:

{
  "name": "王小明",
  "mobile": "0912345678",
  "email": "[email protected]",
  "vip_id": "12345678",
  "points": 100.0,
  "level": "Gold",
  "logs": [
    {
      "vip_id": "12345678",
      "vip_name": "王小明",
      "vip_mobile": "0912345678",
      "vip_email": "[email protected]",
      "shop_id": "000030",
      "shop_name": "台北訓練機",
      "ticket_id": "00003001SA202512150001",
      "ticket_amt": 0.0,
      "input_date": "2025-12-15T11:35:13",
      "point_type": "3",
      "bonuspt_point": 600,
      "crt_date": "2025-12-15T11:35:14",
      "crt_user": null,
      "isexec": true,
      "exec_date": "2025-12-15T11:35:15",
      "online_upt": true,
      "issend": false,
      "transfer_status": "0",
      "last_update": "2025-12-15T11:35:15",
      "deadline": "2025-12-15T11:35:15",
      "group_id": null,
      "gift_vipid": "",
      "gift_vipname": "",
      "amount": 0.0,
      "point_memo": null
    }
  ]
}

Decrypted Data Fields

Name Type Description
name string 會員姓名
mobile string 手機號碼
email string 電子信箱
vip_id string 會員編號
points float 目前點數
level string 會員等級
logs array 點數異動紀錄

Logs Item Fields

Name Type Description
vip_id string 會員編號
vip_name string 會員姓名
vip_mobile string 手機號碼
vip_email string 電子信箱
shop_id string 門市代號
shop_name string 門市名稱
ticket_id string 交易單號
ticket_amt float 交易金額
input_date string 輸入日期
point_type string 點數類型
bonuspt_point float 異動點數
crt_date string 建立日期
crt_user string 建立人員
isexec boolean 是否執行
exec_date string 執行日期
online_upt boolean 線上更新
issend boolean 是否發送
transfer_status string 傳輸狀態
last_update string 最後更新時間
deadline string 到期日
group_id string 群組ID
gift_vipid string 贈送者會員ID
gift_vipname string 贈送者會員姓名
amount float 金額
point_memo string 備註