# Customer/Social

## Get Third-Party Login Configuration Information

> version=0.0.1 bizType=customer.app.CustomerThirdLoginService.config Guest Accessible

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerThirdLoginService.config":{"post":{"summary":"Get Third-Party Login Configuration Information","deprecated":false,"description":"version=0.0.1 bizType=customer.app.CustomerThirdLoginService.config Guest Accessible","operationId":"config","tags":["Customer/Social"],"parameters":[{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Status Return Code, code=0 indicates current request operation success, other codes handle exceptions"},"msg":{"type":"string","description":"Status description"},"bizCode":{"type":"string","description":"Module identifier code"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"","description":"Third-Party Sources: google, facebook, twitter…"},"clientId":{"type":"string","title":"","description":"Client ID"},"developerAccount":{"type":"string","description":"Third-Party Development Account"}},"required":["thirdSource","clientId","developerAccount"],"description":"Data Body"}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Apple Third-party Login Verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.appleVerify\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/appleVerify":{"post":{"summary":"Apple Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.appleVerify\nAccessible after login","operationId":"appleVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"companyId":{"type":"integer","title":"Company ID"},"openId":{"type":"string","title":"Third-party Open ID","description":"Required on app end"},"identityToken":{"type":"string","title":"Identity Token","description":"Required on app end"},"email":{"type":"integer","title":"Optional on app end"},"code":{"type":"string","title":"Authorization Code","description":"Required on web end"},"idToken":{"type":"string","title":"token","description":"Required on web end"}},"required":["companyId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Facebook Third-party Login Verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.facebookVerify\
> Access after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.facebookVerify":{"post":{"summary":"Facebook Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.facebookVerify\nAccess after login","operationId":"facebookVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string","description":"Verify accessToken"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Google Third-party Login Verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.googleVerify\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/googleVerify":{"post":{"summary":"Google Third-party Login Verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.googleVerify\nAccessible after login","operationId":"googleVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idToken":{"type":"string","title":"Token verification required for web"},"accessToken":{"type":"string","title":"Token verification required for app"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"type":"integer","title":"Processing time (milliseconds)"},"trace":{"type":"string","title":"Global link flag information"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"result":{"type":"boolean","title":"Validation Result"},"phone":{"title":"Phone Number","type":"string"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"failReason":{"title":"Validation Failure Reason","type":"string"},"userId":{"type":"string","title":"Third-party userId"},"email":{"type":"string","title":"Email"},"token":{"type":"string","title":"Token verification"}},"required":["thirdSource","result","phone","action","failReason","userId","email","token"],"title":""},"msgParams":{"title":"Placeholder parameter string in return description, multiple parameters separated by commas","type":"string"}},"required":["code","msg","bizCode","tm","trace","data","msgParams"]}}},"headers":{}}}}}}}
```

## Telegram third-party login verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.telegramVerify\
> \###Version 0.0.2, used for third-party registration and login (no need for phone or email)\
> version=0.0.2\
> bizType=customer.app.CustomerThirdLoginService.telegramVerify\
> Access after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.telegramVerify":{"post":{"summary":"Telegram third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\n###Version 0.0.2, used for third-party registration and login (no need for phone or email)\nversion=0.0.2\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\nAccess after login","operationId":"metaMaskVerify","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"userJsonStr":{"type":"string","title":"User authorization information provided as a JSON string"},"channelSource":{"type":"string","title":"Channel Source h5, pc"}},"required":["userJsonStr","channelSource"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information","description":"Return information"},"bizCode":{"type":"string","title":"Module identifier code","description":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer","description":"Processing time (milliseconds)"},"trace":{"type":"string","title":"Global link flag information","description":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId","description":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean","description":"Validation Result"},"failReason":{"type":"string","title":"Validation Failure Reason","description":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"Third-party login sources, google, facebook, twitter…"},"email":{"type":"string","title":"Email","description":"Email"},"phone":{"type":"string","title":"Phone Number","description":"Phone Number"},"authToken":{"type":"string","description":"Third-party authorization credentials (returned version=0.0.2)"}},"required":["userId","phone","email","thirdSource","failReason","result","action","authToken"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Metamask third-party login verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.metaMaskVerify\
> Access after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.metaMaskVerify":{"post":{"summary":"Metamask third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.metaMaskVerify\nAccess after login","operationId":"telegramVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"web3Signature":{"type":"string","title":"Signature verification"},"address":{"type":"string","title":"Wallet account address"},"timestamp":{"type":"integer","title":"Timestamp"}},"required":["web3Signature","address","timestamp"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Twitter third-party login verification

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.twitterVerify\
> Accessible after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.twitterVerify":{"post":{"summary":"Twitter third-party login verification","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.twitterVerify\nAccessible after login","operationId":"twitterVerify","tags":["Customer/Social"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"oauth_token":{"type":"string","title":"","description":"oauth_token"},"oauth_token_secret":{"type":"string","title":"","description":"oauth_token_secret"},"user_id":{"type":"string","title":"","description":"user_id"},"screen_name":{"type":"string","description":"screen_name"},"access_token":{"type":"string","description":"access_token"},"state":{"type":"string","description":"state"},"client_id":{"type":"string","description":"client_id"},"network":{"type":"string","description":"network"},"display":{"type":"string","description":"display"},"redirect_uri":{"type":"string","description":"redirect_uri"},"scope":{"type":"string","description":"scope"},"oauth_proxy":{"type":"string","description":"oauth_proxy"}},"required":["oauth_token","oauth_token_secret","scope","redirect_uri","display","network","client_id","state","access_token","screen_name","user_id","oauth_proxy"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"System General Return Code","description":"0-Success, other exceptions"},"msg":{"type":"string","title":"Return information"},"bizCode":{"type":"string","title":"Module identifier code"},"tm":{"title":"Processing time (milliseconds)","type":"integer"},"trace":{"type":"string","title":"Global link flag information"},"msgParams":{"type":"string","title":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"Third-party userId"},"action":{"type":"string","title":"Next Operation Behavior","description":"login, bind, register"},"result":{"title":"Validation Result","type":"boolean"},"failReason":{"type":"string","title":"Validation Failure Reason"},"thirdSource":{"type":"string","title":"Third-party Login Source","description":"google,facebook,twitter…"},"email":{"type":"string","title":"Email"},"phone":{"type":"string","title":"Phone Number"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Third-party login

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.login\
> Accessible to guests

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.login":{"post":{"summary":"Third-party login","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.login\nAccessible to guests","operationId":"login","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"},"userId":{"type":"string","description":"Third-party userId"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone Number"}},"required":["thirdSource","userId","email","phone"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Customer ID"},"companyId":{"type":"integer","format":"int64","description":"Company"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"customerNo":{"type":"string","description":"Customer account"},"kycAuditStatus":{"type":"integer","format":"int32","description":"Registration KYC audit status: 0 uncertified, jump to certification page, 1 pending review, 2 review passed, 3 review failed"},"kycAuditRemark":{"type":"string","description":"Registration KYC audit remarks, not empty if rejected"},"kycStatus":{"type":"integer","format":"int32","description":"KYC status"},"kycRemark":{"type":"string","description":"KYC status name"},"accountList":{"type":"object","description":"Trading Account List","properties":{}},"accountRemark":{"type":"string","description":"Whether the customer has a trading account note"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"country":{"type":"string","description":"Country"},"type":{"type":"integer","format":"int32","description":"Group type <0 real, 1 demo, 2 guest>"},"deposit":{"type":"integer","format":"int32","description":"Depositable, 1 for depositable"},"withdraw":{"type":"integer","format":"int32","description":"Withdrawable, 1 for withdrawable"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"activateStatus":{"type":"integer","format":"int32","description":"Activation status, 0 not activated, 1 activated"},"activateTime":{"type":"integer","format":"int64","description":"Activation time"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"status":{"type":"integer","format":"int32","description":"Status: 1 normal, 2 disabled, 3 deleted, 4 closed, 5 locked, 6 closing"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"thirdLoginSource":{"type":"string","description":"Third-party login sources google, facebook, twitter"},"thirdUserId":{"type":"string","description":"Third-party userId"},"idCard":{"type":"string","description":"ID number"},"idCardType":{"type":"string","description":"ID type"},"thirdIntactMsg":{"type":"string","description":"Third-party login complete data"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"isFund":{"type":"integer","format":"int32","description":"Whether a fund manager, 1 is yes, default 0 is no"},"assertPassStatus":{"type":"string","description":"Set fund password reminder flag, 1 requires setting password, 2 does not require"},"googleId":{"type":"integer","format":"int64","description":"Whether to enable MFA, greater than 0, enabled, otherwise not enabled"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"loginTime":{"type":"integer","format":"int64","description":"Login time"},"createTime":{"type":"integer","format":"int64","description":"Creation time"},"relationCustomerId":{"type":"integer","format":"int64","description":"Associated account id"},"companyType":{"type":"string","description":"Company type"},"registerSource":{"type":"integer","format":"int32","description":"Registration source"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## Third-party login (no need for phone, email)

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.socialLogin\
> Guest access

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialLogin":{"post":{"summary":"Third-party login (no need for phone, email)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialLogin\nGuest access","operationId":"login","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"thirdSource":{"type":"string","description":"Third-party source telegram"},"userId":{"type":"string","description":"Third-party userId"},"authToken":{"type":"string","description":"Third-party authorization certificate","minLength":64,"maxLength":64}},"required":["thirdSource","userId","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"Customer ID"},"companyId":{"type":"integer","format":"int64","description":"Company"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"customerNo":{"type":"string","description":"Customer account"},"kycAuditStatus":{"type":"integer","format":"int32","description":"Registration KYC audit status: 0 uncertified, jump to certification page, 1 pending review, 2 review passed, 3 review failed"},"kycAuditRemark":{"type":"string","description":"Registration KYC audit remarks, not empty if rejected"},"kycStatus":{"type":"integer","format":"int32","description":"KYC status"},"kycRemark":{"type":"string","description":"KYC status name"},"accountList":{"type":"object","description":"Trading Account List","properties":{}},"accountRemark":{"type":"string","description":"Whether the customer has a trading account note"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"country":{"type":"string","description":"Country"},"type":{"type":"integer","format":"int32","description":"Group type <0 real, 1 demo, 2 guest>"},"deposit":{"type":"integer","format":"int32","description":"Depositable, 1 for depositable"},"withdraw":{"type":"integer","format":"int32","description":"Withdrawable, 1 for withdrawable"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"activateStatus":{"type":"integer","format":"int32","description":"Activation status, 0 not activated, 1 activated"},"activateTime":{"type":"integer","format":"int64","description":"Activation time"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"status":{"type":"integer","format":"int32","description":"Status: 1 normal, 2 disabled, 3 deleted, 4 closed, 5 locked, 6 closing"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"thirdLoginSource":{"type":"string","description":"Third-party login source telegram"},"thirdUserId":{"type":"string","description":"Third-party userId"},"idCard":{"type":"string","description":"ID number"},"idCardType":{"type":"string","description":"ID type"},"thirdIntactMsg":{"type":"string","description":"Third-party login complete data"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"isFund":{"type":"integer","format":"int32","description":"Whether a fund manager, 1 is yes, default 0 is no"},"assertPassStatus":{"type":"string","description":"Set fund password reminder flag, 1 requires setting password, 2 does not require"},"googleId":{"type":"integer","format":"int64","description":"Whether to enable MFA, greater than 0, enabled, otherwise not enabled"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"loginTime":{"type":"integer","format":"int64","description":"Login time"},"createTime":{"type":"integer","format":"int64","description":"Creation time"},"relationCustomerId":{"type":"integer","format":"int64","description":"Associated account id"},"companyType":{"type":"string","description":"Company type"},"registerSource":{"type":"integer","format":"int32","description":"Registration source"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## Third-party registration

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.register\
> Guest access

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.register":{"post":{"summary":"Third-party registration","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.register\nGuest access","operationId":"register","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country"},"thirdSource":{"type":"string","description":"Third-Party Sources: google, facebook, twitter, telegram, apple, metamask"},"userId":{"type":"string","description":"Third-party userId"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"email":{"type":"string","description":"Email and phone number must exist one"},"phone":{"type":"string","description":"Phone Number"},"phoneArea":{"type":"string","description":"New phone area code"},"verifyCode":{"type":"string","description":"Verification code"},"sendToken":{"type":"string","description":"Verification code sending ticket"},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"Registration source: 1=mobile web: H5, 2=pc web: PC_Web, 3=system & backend registration: System, 4=Android native app: Android, 5=iOS native app: iOS, 6=HarmonyOS: HOS, 7=pc windows client: PC_Win, 8=pc mac client: PC_Mac, 9=other"},"utmSource":{"type":"string","description":"Advertising source (account opening link parameter source)"},"utmMedium":{"type":"string","description":"Advertising medium (account opening link parameter medium)"},"utmCampaign":{"type":"string","description":"Advertising campaign (account opening link parameter campaign)"},"utmContent":{"type":"string","description":"Advertising group (account opening link parameter content)"},"utmTerm":{"type":"string","description":"Keyword (account opening link parameter term)"},"lang":{"type":"string","description":"Language Information"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system","maxLength":45},"thirdServerSource":{"type":"string","description":"Third-party system source, such as: agent=agent","maxLength":10},"registerDevice":{"type":"string","description":"Registered device model"}},"required":["country"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"Customer account"},"list":{"type":"array","description":"KYC authentication list information","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"Company ID"},"ext1":{"type":"string","description":"Extension Field (Unused)"},"ext2":{"type":"string","description":"Extension Field (Unused)"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"country":{"type":"string","description":"Country"},"id":{"type":"integer","format":"int64","description":"Customer ID"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"capitalInStatus":{"type":"integer","format":"int32","description":"Deposit status: 1. Deposited, 2. Not deposited"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"companyType":{"type":"string","description":"Company type"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"},"apiCheckSwitch":{"type":"boolean","description":"API verification switch. true-verification is enabled"},"apiCheckRule":{"type":"string","description":"API Verification Rules. 1-Email; 2-SMS; 3-Google NFA; Enable multiple verifications at the same time, separated by commas."},"token":{"type":"string","description":"Login Token"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"Level Code"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"levelName":{"type":"string","description":"Level Name"},"pathName":{"type":"string","description":"KYC Path Name"},"pathCode":{"type":"string","description":"KYC Path Code"},"elementList":{"type":"array","description":"KYC Information List","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC element code"},"elementName":{"type":"string","description":"KYC element name"},"showType":{"type":"string","description":"KYC element display type"},"extend":{"type":"string","description":"KYC element extended attribute"},"elementValue":{"type":"string","description":"KYC element value"},"elementValueInputGroup":{"type":"string","description":"KYC element value, combination"},"elementCodeInputGroup":{"type":"string","description":"KYC element code, combination"}}}}}}
```

## Third-party registration (no need for phone, email)

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.socialRegister\
> Accessible for guests

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Social"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialRegister":{"post":{"summary":"Third-party registration (no need for phone, email)","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialRegister\nAccessible for guests","operationId":"register","tags":["Customer/Social"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country code"},"thirdSource":{"type":"string","description":"Third-party source telegram"},"userId":{"type":"string","description":"Third-party userId"},"authToken":{"type":"string","description":"Third-party authorization certificate","minLength":64,"maxLength":64},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"Registration source: 1=mobile web: H5, 2=pc web: PC_Web, 3=system & backend registration: System, 4=Android native app: Android, 5=iOS native app: iOS, 6=HarmonyOS: HOS, 7=pc windows client: PC_Win, 8=pc mac client: PC_Mac, 9=other"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"utmSource":{"type":"string","description":"Advertising source (account opening link parameter source)"},"utmMedium":{"type":"string","description":"Advertising medium (account opening link parameter medium)"},"utmCampaign":{"type":"string","description":"Advertising campaign (account opening link parameter campaign)"},"utmContent":{"type":"string","description":"Advertising group (account opening link parameter content)"},"utmTerm":{"type":"string","description":"Keyword (account opening link parameter term)"},"lang":{"type":"string","description":"Language Information"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system","maxLength":45},"thirdServerSource":{"type":"string","description":"Third-party system source, such as: agent=agent","maxLength":10},"registerDevice":{"type":"string","description":"Registered device model"},"token":{"type":"string","description":"Login Token"}},"required":["country","thirdSource","userId","registerSource","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"Customer account"},"list":{"type":"array","description":"KYC authentication list information","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"Company ID"},"ext1":{"type":"string","description":"Extension Field (Unused)"},"ext2":{"type":"string","description":"Extension Field (Unused)"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"customerGroupId":{"type":"integer","format":"int64","description":"Customer group"},"country":{"type":"string","description":"Country"},"id":{"type":"integer","format":"int64","description":"Customer ID"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"capitalInStatus":{"type":"integer","format":"int32","description":"Deposit status: 1. Deposited, 2. Not deposited"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"companyType":{"type":"string","description":"Company type"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"},"apiCheckSwitch":{"type":"boolean","description":"API verification switch. true-verification is enabled"},"apiCheckRule":{"type":"string","description":"API Verification Rules. 1-Email; 2-SMS; 3-Google NFA; Enable multiple verifications at the same time, separated by commas."}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"Level Code"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"levelName":{"type":"string","description":"Level Name"},"pathName":{"type":"string","description":"KYC Path Name"},"pathCode":{"type":"string","description":"KYC Path Code"},"elementList":{"type":"array","description":"KYC Information List","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC element code"},"elementName":{"type":"string","description":"KYC element name"},"showType":{"type":"string","description":"KYC element display type"},"extend":{"type":"string","description":"KYC element extended attribute"},"elementValue":{"type":"string","description":"KYC element value"},"elementValueInputGroup":{"type":"string","description":"KYC element value, combination"},"elementCodeInputGroup":{"type":"string","description":"KYC element code, combination"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.multimarkets.org/client-api/more.../customer-social.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.