Skip to content

Get Member Data

Description

取得會員資料。

Resource

GET /v1/user

Authorization

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

Query Parameters

Name Type Description
source string 來源
ALLOWED VALUES:
  • SOOCKER

(optional)

Response Body Parameters

Name Type Description
id string 會員ID
name string 姓名
zip string 郵遞區號
address string 地址
area_code string 市話區碼
telephone string 電話
extension_number string 分機號碼
sex string 性別
ALLOWED VALUES:
  • male:男
  • female:女
  • unknown:未設定
birthday string 生日
email string 信箱
mobile string 手機號碼
group_id string 會員群組ID
group_name string 會員群組名稱
card_no string 會員卡卡號
phone_carrier string 手機載具
points string 會員持有點數
Invitation_code string 邀請碼
seal_quantity integer 集章數量
(optional)
會員沒有集章數量資訊時,將不會回傳此參數.
points_exchanged_amount integer 點數兌換金額
type string 類型
ALLOWED VALUES:
  • FRIEND
  • MEMBER
update_birthday_time string 修改生日時間
tax_id_number string 統一編號
(optional)
citizen_digital_certificate string 自然人憑證
default_carrier_type string 預設載具類別
ALLOWED VALUES:
  • PHONE_CARRIER
  • MEMBER_CARRIER
  • CITIZEN_DIGITAL_CERTIFICATE
is_blacklist boolean 是否為黑名單
memo string 備註
member_card_image_url string 會員卡圖檔網址
tickets integer 會員持有票券張數
prepaid_card_no string 會員實體卡卡號
vip_level_validity_date string 會員等級有效期限
member_discount_rate Member Discount Rate 會員折扣率
city string 居住城市
(optional)
district string 居住區域
(optional)

Response Body Parameters - Member Discount Rate

Name Type Description
product_category_id string 商品類別編號
discount_rate float 會員折扣率

Response

{
  "id": "021100543",
  "name": "Jane",
  "zip": null,
  "address": "台北市大安區復興南路二段171巷20號1樓",
  "area_code": "02",
  "telephone": "27006275",
  "extension_number": "20",
  "sex": "Female",
  "birthday": "2020-01-01T00:00:00",
  "email": "[email protected]",
  "mobile": "0987654321",
  "points": "100",
  "group_id": "APP",
  "group_name": "品牌APP會員",
  "card_no": "",
  "phone_carrier": "",
  "Invitation_code": "6vq4tt",
  "seal_quantity": 0,
  "points_exchanged_amount": 10,
  "type": "MEMBER",
  "update_birthday_time": "None",
  "tax_id_number": "",
  "citizen_digital_certificate": "",
  "default_carrier_type": "PHONE_CARRIER",
  "is_blacklist": false,
  "memo": "",
  "member_card_image_url": "https://member_card_image_url.wixtar.com",
  "tickets": 1,
  "prepaid_card_no": "",
  "vip_level_validity_date": "2024-12-12",
  "member_discount_rate": [
    {
      "product_category_id": "DEP_ID_001",
      "discount_rate": 0.8
    },
    {
      "product_category_id": "DEP_ID_002",
      "discount_rate": 0.7
    }
  ]
}