Skip to main content

Query Member Profile

Function​

Query Member Profile 查詢用戶信息

Endpoint​

  • /v1/member/profile

HTTP Method​

  • POST

Request Body​

Query Member By vip_code or vip_accountno

{
  "search_type": "vip",
  "search_value": "0480000427741101"
}

Query Member By vip_code

{
  "search_type": "vip_code",
  "search_value": "0480000427741101"
}

Query Member By vip_accountno

{
  "search_type": "vip_accountno",
  "search_value": "0480000427741101"
}

Query Member By email

{
  "search_type": "email",
  "search_value": "XXX@XXX.XXX"
}

Query Member By phone

{
  "search_type": "phone",
  "search_value": "8XXXXX",
  "phone_region": "852"
}

Query Member By kdp_member_id

{
  "search_type": "kdp_member_id",
  "search_value": "00000095XXX"
}

Request Parameters​

FieldRequiredTypeRemarkSample
search_typeYesstring查詢類型: vip、vip_code、vip_accountno、email、phone、kdp_member_idphone
search_valueYesstring查詢內容8XXXXX
phone_regionNOstring手機區號852

Response Body - Success​

{
    "code": 0,
    "msg": "success",
    "data": {
        "vip_code": "0480000427741101",
        "vip_accountno": "0480000427741101",
        "last_name_en": "Zhang",
        "first_name_en": "Three",
        "last_name_zh": "张",
        "first_name_zh": "三",
        "address": "",
        "phone_number": "88123456",
        "phone_region": "852",
        "is_phone_auth": "1",
        "birthday_year": "2000",
        "birthday_month": "1",
        "birthday_day": "1",
        "gender": "F",
        "joint_date": "2023-09-21T00:00:00+08:00",
        "expiry_date": "2122-09-30T00:00:00+08:00",
        "issue_date": "2023-09-21T00:00:00+08:00",
        "mall_id": "DP01",
        "is_active": "1",
        "email": "123456@test.test",
        "age_group": "03",
        "marital_status": "",
        "had_child": "",
        "child_age_group": ["01"],
        "country": "100001",
        "province": "100001001",
        "language": "01",
        "one_id": "",
        "agree_statement": "1",
        "agree_tier_matching":"1",
        "pipl_1_agree": "1",
        "pipl_3_sensitive": "1",
        "pipl_4_transfer": "1",
        "pipl_5_3rd": "1",
        "pipl_6_optin": "1",
        "pipl_7_direct_optin": "1",
        "title": "03",
        "grade":"80",
        "tier_code":"General",
        "pics_consent":"1",
        "pics_consent_timestamp":"1695276214",
        "kdp_member_id":"",
        "agree_minor":"0",
        "pipl_consent_version":"",
        "pipl_consent_timestamp":"",
        "curbonus":"0",
        "bonus_expiry_date":"2024-09-20"
    }
}

Diff FZ API​

FZ API : GetMemberInfoByVipAccountNo 、GetMemberInfoByTelephone、GetMemberInfoByVipEmail

FZNewRemark
VIPCODEvip_code
SURNAMEfirst_name_zh
GIVENNAMEfirst_name_en
ENGFAMILYNAMElast_name_en
ADDRESS1address
ADDRESS2/
ADDRESS3/
ADDRESS4/
TELEPHONEphone_number
TELEPHONE2/
VIPID/
DOB/
BIRTHDAYYYYYbirthday_year
BIRTHDAYMMbirthday_month
BIRTHDAYDDbirthday_day
SEXgender
GRADEgrade
JOINTDATEjoint_date調整rfc3339格式
EXPIRYDATEexpiry_date調整rfc3339格式
ISSUEDATEissue_date調整rfc3339格式
ISSUESTOREmall_id
ISSUETILLID/
FIRSTPURDATE/
LASTPURDATE/
ACCUMPUR/
TTLPURCOUNT/
ACTIVEis_active
REMARKS1/
REMARKS2/
POSTAL/
VIPEMAILemail
DEFSALESMAN/
LASTBONUSRESETDATE/
GROUPVALUETIME/
GROUPID0/
GROUPID1/
GROUPID2/
GROUPID3/
GROUPID4/
GROUPID5/
GROUPID6/
GROUPID7/
GROUPID8/
GROUPID9/
GROUPID10/
GROUPID11/
GROUPID12/
GROUPID13/
GROUPID14/
GROUPID15/
GROUPID16/
GROUPID17/
GROUPID18/
GROUPID19/
DLFLAG/
LASTMODBY/
LASTMODTIME/
LASTUPLOADTIME/
ISSUEBY/
ISSUETIME/
LASTRENEWDATE/
LASTRENEWSTORECODE/
NEWACCUMPUR/
NEWTTLPURCOUNT/
CURRBONUSUSED/
PREVBONUSUSED/
MOBILENOTE/
JOURNAL/
BANKCARDNO/
VIPACCOUNTNOvip_accountno
VIPCARDNO/
PASSWORD/不返回密碼
CURBONUScurbonus
LIKEPRODUCT/
INTEREST/
TOCHINATIMES/
TOCHINAREASON/
EARNBONUS/
BONUSEXPIRYDATEbonus_expiry_date
NAMEONCARD/
CHNFAMILYNAMElast_name_zh
AGEGROUPage_group
CERTIFICATETYPE/
MARITALSTATUSmarital_status
HADCHILDhad_child
CHILDAGEGROUPchild_age_group調整為數組
INCOMECODE/
CONTINENT/
COUNTRYcountry
PROVINCEprovince
CITY/
ZONE/
LIKEPRODUCTOTHER/
INTERESTOTHER/
ISPHONEAUTHENTICATIONis_phone_auth
TELEPHONECOUNTRYCODEphone_region
STUDENTCARDIMAGE/
ISAGREESTATEMENTagree_statementFZ DB 同意=0，需調整為同意=1
ISAGREETIERMATCHINGagree_tier_matching
LANGUAGElanguage
ONEREGISTERMEMBERLOGINIDone_id
CNPIPL_1_AGREEpipl_1_agree
CNPIPL_2_CONSENT/
CNPIPL_3_SENSITIVEpipl_3_sensitive
CNPIPL_4_TRANSFERpipl_4_transfer
CNPIPL_5_3RDpipl_5_3rd
CNPIPL_6_OPTINpipl_6_optin
CNPIPL_7_DIRECT_OPTINpipl_7_direct_optin
CONSENT_VERSIONpipl_consent_version
AGREE_MINORagree_minor
TITLEtitle
PICS_CONSENTpics_consent
PICS_CONSENT_TIMESTAMPpics_consent_timestampUNIX Timestamp in Seconds(10 位數值) , 东八区
PIPL_CONSENT_TIMESTAMP/
ApprovedFirstSalesmemo/
GradeGroup/
SalesStartDate/
SalesEndDate/
PeriodSalesAmount/
PeriodTargetSalesAmount/
MBRCategoryList.Item.MBRCATEID/
MBRCategoryList.Item.MBRCATEGORY/
MBRCategoryList.Item.RANKING/
KidVipMember/
/tier_code新增等級代碼
/kdp_member_id新增

UAT FZ API Response​

{
  "MemberInfo": {
    "Member": {
      "VIPCODE": "0480000427741101",
      "SURNAME": "strChnName",
      "GIVENNAME": "EngName",
      "ENGFAMILYNAME": "EngFamilyName",
      "ADDRESS1": "",
      "ADDRESS2": "",
      "ADDRESS3": "",
      "ADDRESS4": "",
      "TELEPHONE": "123456",
      "TELEPHONE2": "",
      "VIPID": "",
      "DOB": "",
      "BIRTHDAYYYYY": "2000",
      "BIRTHDAYMM": "1",
      "BIRTHDAYDD": "10",
      "SEX": "F",
      "GRADE": "80",
      "JOINTDATE": "9/21/2023 12:00:00 AM",
      "EXPIRYDATE": "9/30/2122 12:00:00 AM",
      "ISSUEDATE": "9/21/2023 12:00:00 AM",
      "ISSUESTORE": "DP01",
      "ISSUETILLID": "",
      "FIRSTPURDATE": "",
      "LASTPURDATE": "",
      "ACCUMPUR": "",
      "TTLPURCOUNT": "",
      "ACTIVE": "1",
      "REMARKS1": "",
      "REMARKS2": "",
      "POSTAL": "",
      "VIPEMAIL": "123456@t.t",
      "DEFSALESMAN": "",
      "LASTBONUSRESETDATE": "",
      "GROUPVALUETIME": "",
      "GROUPID0": "",
      "GROUPID1": "",
      "GROUPID2": "",
      "GROUPID3": "",
      "GROUPID4": "",
      "GROUPID5": "",
      "GROUPID6": "",
      "GROUPID7": "",
      "GROUPID8": "",
      "GROUPID9": "",
      "GROUPID10": "",
      "GROUPID11": "",
      "GROUPID12": "",
      "GROUPID13": "",
      "GROUPID14": "",
      "GROUPID15": "",
      "GROUPID16": "",
      "GROUPID17": "",
      "GROUPID18": "04-80-00042774-1-1-01",
      "GROUPID19": "",
      "DLFLAG": "1",
      "LASTMODBY": "BE",
      "LASTMODTIME": "9/21/2023 2:03:34 PM",
      "LASTUPLOADTIME": "",
      "ISSUEBY": "BE",
      "ISSUETIME": "",
      "LASTRENEWDATE": "",
      "LASTRENEWSTORECODE": "",
      "NEWACCUMPUR": "",
      "NEWTTLPURCOUNT": "",
      "CURRBONUSUSED": "0",
      "PREVBONUSUSED": "0",
      "MOBILENOTE": "",
      "JOURNAL": "",
      "BANKCARDNO": "",
      "VIPACCOUNTNO": "0480000427741101",
      "VIPCARDNO": "123456",
      "PASSWORD": "XXXXXX",
      "CURBONUS": "0",
      "LIKEPRODUCT": "",
      "INTEREST": "",
      "TOCHINATIMES": "",
      "TOCHINAREASON": "",
      "EARNBONUS": "",
      "BONUSEXPIRYDATE": "2024-09-20",
      "NAMEONCARD": "strNameOnCard",
      "CHNFAMILYNAME": "ChnFamilyName",
      "AGEGROUP": "03",
      "CERTIFICATETYPE": "",
      "MARITALSTATUS": "",
      "HADCHILD": "",
      "CHILDAGEGROUP": "",
      "INCOMECODE": "",
      "CONTINENT": "",
      "COUNTRY": "100001",
      "PROVINCE": "",
      "CITY": "",
      "ZONE": "",
      "LIKEPRODUCTOTHER": "",
      "INTERESTOTHER": "",
      "ISPHONEAUTHENTICATION": "",
      "TELEPHONECOUNTRYCODE": "+852",
      "STUDENTCARDIMAGE": "",
      "ISAGREESTATEMENT": "",
      "ISAGREETIERMATCHING": "1",
      "LANGUAGE": "01",
      "ONEREGISTERMEMBERLOGINID": "",
      "CNPIPL_1_AGREE": "0",
      "CNPIPL_2_CONSENT": "0",
      "CNPIPL_3_SENSITIVE": "0",
      "CNPIPL_4_TRANSFER": "0",
      "CNPIPL_5_3RD": "0",
      "CNPIPL_6_OPTIN": "0",
      "CNPIPL_7_DIRECT_OPTIN": "0",
      "CONSENT_VERSION": "",
      "AGREE_MINOR": "",
      "TITLE": "",
      "PICS_CONSENT": "true",
      "PICS_CONSENT_TIMESTAMP": "1695276214",
      "PIPL_CONSENT_TIMESTAMP": "1695276214",
      "ApprovedFirstSalesmemo": "0",
      "GradeGroup": "DP",
      "SalesStartDate": "2023-09-21",
      "SalesEndDate": "2023-11-19",
      "PeriodSalesAmount": "0",
      "PeriodTargetSalesAmount": "1500",
      "MBRCategoryList": {
        "Item": {
          "MBRCATEID": "-1",
          "MBRCATEGORY": "",
          "RANKING": "0"
        }
      }
    },
    "KidVipMember": null
  }
}