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 | 手機號碼 |
| 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 | 備註 |