# 客户接口/社交账号登录

## 获取三方登录配置信息

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.config\
> 游客可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerThirdLoginService.config":{"post":{"summary":"获取三方登录配置信息","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.config\n游客可访问","operationId":"config","tags":["客户接口/社交账号登录"],"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":"第三方源 google,facebook,twitter,telegram,apple,metamask"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"状态返回码，code=0标识当前请求操作成功，其他code处理异常"},"msg":{"type":"string","description":"状态描述"},"bizCode":{"type":"string","description":"模块标识码"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"","description":"第三方源 google,facebook,twitter…"},"clientId":{"type":"string","title":"","description":"客户端id"},"developerAccount":{"type":"string","description":"三方开发账户"}},"required":["thirdSource","clientId","developerAccount"],"description":"数据体"}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Apple三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.appleVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/appleVerify":{"post":{"summary":"Apple三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.appleVerify\n登录之后可以访问","operationId":"appleVerify","tags":["客户接口/社交账号登录"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"companyId":{"type":"integer","title":"公司id"},"openId":{"type":"string","title":"第三方开放id","description":"app端必传"},"identityToken":{"type":"string","title":"身份token","description":"app端必传"},"email":{"type":"integer","title":"app端有就传"},"code":{"type":"string","title":"授权code","description":"web端必传"},"idToken":{"type":"string","title":"token","description":"web端必传"}},"required":["companyId"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息"},"bizCode":{"type":"string","title":"模块标识码"},"tm":{"title":"处理时长（毫秒）","type":"integer"},"trace":{"type":"string","title":"全局链路标志信息"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"第三方userId"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"result":{"title":"校验结果","type":"boolean"},"failReason":{"type":"string","title":"校验失败原因"},"thirdSource":{"type":"string","title":"第三方登录源","description":"google,facebook,twitter…"},"email":{"type":"string","title":"邮箱"},"phone":{"type":"string","title":"手机号"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Facebook三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.facebookVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.facebookVerify":{"post":{"summary":"Facebook三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.facebookVerify\n登录之后可以访问","operationId":"facebookVerify","tags":["客户接口/社交账号登录"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"accessToken":{"type":"string","description":"校验accessToken"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息"},"bizCode":{"type":"string","title":"模块标识码"},"tm":{"title":"处理时长（毫秒）","type":"integer"},"trace":{"type":"string","title":"全局链路标志信息"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"第三方userId"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"result":{"title":"校验结果","type":"boolean"},"failReason":{"type":"string","title":"校验失败原因"},"thirdSource":{"type":"string","title":"第三方登录源","description":"google,facebook,twitter…"},"email":{"type":"string","title":"邮箱"},"phone":{"type":"string","title":"手机号"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Google三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.googleVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/h/com.cats.customer.api.app.CustomerThirdLoginService/googleVerify":{"post":{"summary":"Google三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.googleVerify\n登录之后可以访问","operationId":"googleVerify","tags":["客户接口/社交账号登录"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"idToken":{"type":"string","title":"校验token web端必传"},"accessToken":{"type":"string","title":"校验token app端必传"}}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息"},"bizCode":{"type":"string","title":"模块标识码"},"tm":{"type":"integer","title":"处理时长（毫秒）"},"trace":{"type":"string","title":"全局链路标志信息"},"data":{"type":"object","properties":{"thirdSource":{"type":"string","title":"第三方登录源","description":"google,facebook,twitter…"},"result":{"type":"boolean","title":"校验结果"},"phone":{"title":"手机号","type":"string"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"failReason":{"title":"校验失败原因","type":"string"},"userId":{"type":"string","title":"第三方userId"},"email":{"type":"string","title":"邮箱"},"token":{"type":"string","title":"校验token"}},"required":["thirdSource","result","phone","action","failReason","userId","email","token"],"title":""},"msgParams":{"title":"返回描述中占位符参数串，多个参数间以,分割","type":"string"}},"required":["code","msg","bizCode","tm","trace","data","msgParams"]}}},"headers":{}}}}}}}
```

## Telegram三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.telegramVerify\
> \###0.0.2版本，配合三方注册，登录（不需要手机、邮箱）使用\
> version=0.0.2\
> bizType=customer.app.CustomerThirdLoginService.telegramVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.telegramVerify":{"post":{"summary":"Telegram三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\n###0.0.2版本，配合三方注册，登录（不需要手机、邮箱）使用\nversion=0.0.2\nbizType=customer.app.CustomerThirdLoginService.telegramVerify\n登录之后可以访问","operationId":"metaMaskVerify","tags":["客户接口/社交账号登录"],"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":"用户授权信息 以json字符串给出"},"channelSource":{"type":"string","title":"渠道来源 h5、pc"}},"required":["userJsonStr","channelSource"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息","description":"返回信息"},"bizCode":{"type":"string","title":"模块标识码","description":"模块标识码"},"tm":{"title":"处理时长（毫秒）","type":"integer","description":"处理时长（毫秒）"},"trace":{"type":"string","title":"全局链路标志信息","description":"全局链路标志信息"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"第三方userId","description":"第三方userId"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"result":{"title":"校验结果","type":"boolean","description":"校验结果"},"failReason":{"type":"string","title":"校验失败原因","description":"校验失败原因"},"thirdSource":{"type":"string","title":"第三方登录源","description":"第三方登录源,google,facebook,twitter…"},"email":{"type":"string","title":"邮箱","description":"邮箱"},"phone":{"type":"string","title":"手机号","description":"手机号"},"authToken":{"type":"string","description":"三方授权凭证（version=0.0.2返回）"}},"required":["userId","phone","email","thirdSource","failReason","result","action","authToken"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Metamask三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.metaMaskVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.metaMaskVerify":{"post":{"summary":"Metamask三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.metaMaskVerify\n登录之后可以访问","operationId":"telegramVerify","tags":["客户接口/社交账号登录"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"web3Signature":{"type":"string","title":"校验签名"},"address":{"type":"string","title":"钱包账户地址"},"timestamp":{"type":"integer","title":"时间戳"}},"required":["web3Signature","address","timestamp"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","title":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息"},"bizCode":{"type":"string","title":"模块标识码"},"tm":{"title":"处理时长（毫秒）","type":"integer"},"trace":{"type":"string","title":"全局链路标志信息"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"第三方userId"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"result":{"title":"校验结果","type":"boolean"},"failReason":{"type":"string","title":"校验失败原因"},"thirdSource":{"type":"string","title":"第三方登录源","description":"google,facebook,twitter…"},"email":{"type":"string","title":"邮箱"},"phone":{"type":"string","title":"手机号"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## Twitter三方登录校验

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.twitterVerify\
> 登录之后可以访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.twitterVerify":{"post":{"summary":"Twitter三方登录校验","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.twitterVerify\n登录之后可以访问","operationId":"twitterVerify","tags":["客户接口/社交账号登录"],"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":"系统通用返回码","description":"0-成功，其他异常"},"msg":{"type":"string","title":"返回信息"},"bizCode":{"type":"string","title":"模块标识码"},"tm":{"title":"处理时长（毫秒）","type":"integer"},"trace":{"type":"string","title":"全局链路标志信息"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"userId":{"type":"string","title":"第三方userId"},"action":{"type":"string","title":"下一步操作行为","description":"login, bind, register"},"result":{"title":"校验结果","type":"boolean"},"failReason":{"type":"string","title":"校验失败原因"},"thirdSource":{"type":"string","title":"第三方登录源","description":"google,facebook,twitter…"},"email":{"type":"string","title":"邮箱"},"phone":{"type":"string","title":"手机号"}},"required":["userId","phone","email","thirdSource","failReason","result","action"]}},"required":["code","data","msgParams","trace","tm","bizCode","msg"]}}},"headers":{}}}}}}}
```

## 三方登录

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.login\
> 游客可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.login":{"post":{"summary":"三方登录","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.login\n游客可访问","operationId":"login","tags":["客户接口/社交账号登录"],"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":"第三方源 google,facebook,twitter,telegram,apple,metamask"},"userId":{"type":"string","description":"第三方userId"},"email":{"type":"string","description":"邮箱"},"phone":{"type":"string","description":"手机号"}},"required":["thirdSource","userId","email","phone"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"客户id"},"companyId":{"type":"integer","format":"int64","description":"公司"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组"},"customerNo":{"type":"string","description":"客户账号"},"kycAuditStatus":{"type":"integer","format":"int32","description":"注册KYC审核状态:0未认证跳转到认证页面,1待审核,2审核通过,3审核不通过"},"kycAuditRemark":{"type":"string","description":"注册KYC审核备注,审核拒绝不为空"},"kycStatus":{"type":"integer","format":"int32","description":"KYC状态"},"kycRemark":{"type":"string","description":"KYC状态名称"},"accountList":{"type":"object","description":"交易账户列表","properties":{}},"accountRemark":{"type":"string","description":"客户是否有交易账户备注"},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要"},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在"},"email":{"type":"string","description":"邮箱"},"phone":{"type":"string","description":"手机"},"phoneArea":{"type":"string","description":"手机区号"},"name":{"type":"string","description":"姓名"},"country":{"type":"string","description":"国家"},"type":{"type":"integer","format":"int32","description":"组类型 <0真实，1模拟，2游客>"},"deposit":{"type":"integer","format":"int32","description":"可存款,1可存款"},"withdraw":{"type":"integer","format":"int32","description":"可取款,1可取款"},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加"},"activateStatus":{"type":"integer","format":"int32","description":"激活状态，0未激活，1已激活"},"activateTime":{"type":"integer","format":"int64","description":"激活时间"},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启"},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号"},"source":{"type":"string","description":"来源"},"thirdLoginSource":{"type":"string","description":"第三方登录源 google,facebook,twitter"},"thirdUserId":{"type":"string","description":"第三方userId"},"idCard":{"type":"string","description":"证件号码"},"idCardType":{"type":"string","description":"证件类型"},"thirdIntactMsg":{"type":"string","description":"第三方登录完整数据"},"firstName":{"type":"string","description":"名"},"lastName":{"type":"string","description":"姓"},"isFund":{"type":"integer","format":"int32","description":"是否为基金经理，1是，默认0否"},"assertPassStatus":{"type":"string","description":"设置资金密码提醒标志，1需要设置密码，2不需要"},"googleId":{"type":"integer","format":"int64","description":"是否开启MFA，大于0，开启，其余未开启"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"loginTime":{"type":"integer","format":"int64","description":"登陆时间"},"createTime":{"type":"integer","format":"int64","description":"创建时间"},"relationCustomerId":{"type":"integer","format":"int64","description":"关联账户id"},"companyType":{"type":"string","description":"公司类型"},"registerSource":{"type":"integer","format":"int32","description":"注册来源"},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id"},"registerTime":{"type":"integer","format":"int64","description":"注册时间"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## 三方注册

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.register\
> 游客可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.register":{"post":{"summary":"三方注册","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.register\n游客可访问","operationId":"register","tags":["客户接口/社交账号登录"],"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":"国家"},"thirdSource":{"type":"string","description":"第三方源 google,facebook,twitter,telegram,apple,metamask"},"userId":{"type":"string","description":"第三方userId"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组ID"},"email":{"type":"string","description":"邮箱 与手机号码必须存在一个"},"phone":{"type":"string","description":"手机号码"},"phoneArea":{"type":"string","description":"新手机区号"},"verifyCode":{"type":"string","description":"验证码"},"sendToken":{"type":"string","description":"验证码发送票据"},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"注册来源:1=移动端web：H5，2=pcweb：PC_Web，3=系统&后台注册：System，4=安卓原生app：Android，5=苹果原生app：iOS，6=鸿蒙OS：HOS，7=pc windows客户端：PC_Win,8=pc mac客户端：PC_Mac，9=不属于以上的：其他"},"utmSource":{"type":"string","description":"广告来源(开户链接参数source)"},"utmMedium":{"type":"string","description":"广告媒介(开户链接参数medium)"},"utmCampaign":{"type":"string","description":"广告系列(开户链接参数campaign)"},"utmContent":{"type":"string","description":"广告组(开户链接参数content)"},"utmTerm":{"type":"string","description":"关键词(开户链接参数term)"},"lang":{"type":"string","description":"语言信息"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号","maxLength":45},"thirdServerSource":{"type":"string","description":"第三方系统来源，如：代理=agent","maxLength":10},"registerDevice":{"type":"string","description":"注册的设备型号"}},"required":["country"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"客户账号"},"list":{"type":"array","description":"KYC认证列表信息","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"公司ID"},"ext1":{"type":"string","description":"扩展字段(无用)"},"ext2":{"type":"string","description":"扩展字段(无用)"},"email":{"type":"string","description":"邮箱"},"phone":{"type":"string","description":"手机"},"phoneArea":{"type":"string","description":"手机区号"},"name":{"type":"string","description":"姓名"},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要"},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组"},"country":{"type":"string","description":"国家"},"id":{"type":"integer","format":"int64","description":"客户id"},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加"},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号"},"source":{"type":"string","description":"来源"},"capitalInStatus":{"type":"integer","format":"int32","description":"入金状态:1已入金、2未入金"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"companyType":{"type":"string","description":"公司类型"},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id"},"registerTime":{"type":"integer","format":"int64","description":"注册时间"},"apiCheckSwitch":{"type":"boolean","description":"API 校验开关。true-已打开校验"},"apiCheckRule":{"type":"string","description":"API 校验规则。1-邮件；2-短信；3-谷歌NFA；同时启用多个校验，以,分割。"},"token":{"type":"string","description":"登录票据"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"等级code"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"levelName":{"type":"string","description":"等级名称"},"pathName":{"type":"string","description":"KYC路径名称"},"pathCode":{"type":"string","description":"KYC路径code"},"elementList":{"type":"array","description":"KYC信息列表","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC元素code"},"elementName":{"type":"string","description":"KYC元素名称"},"showType":{"type":"string","description":"KYC元素显示类型"},"extend":{"type":"string","description":"KYC元素扩展属性"},"elementValue":{"type":"string","description":"KYC元素值"},"elementValueInputGroup":{"type":"string","description":"KYC元素值，组合"},"elementCodeInputGroup":{"type":"string","description":"KYC元素code，组合"}}}}}}
```

## 三方登录（不需要手机，邮箱）

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.socialLogin\
> 游客可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialLogin":{"post":{"summary":"三方登录（不需要手机，邮箱）","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialLogin\n游客可访问","operationId":"login","tags":["客户接口/社交账号登录"],"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":"第三方源 telegram"},"userId":{"type":"string","description":"第三方userId"},"authToken":{"type":"string","description":"三方授权凭证","minLength":64,"maxLength":64}},"required":["thirdSource","userId","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"id":{"type":"integer","format":"int64","description":"客户id"},"companyId":{"type":"integer","format":"int64","description":"公司"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组"},"customerNo":{"type":"string","description":"客户账号"},"kycAuditStatus":{"type":"integer","format":"int32","description":"注册KYC审核状态:0未认证跳转到认证页面,1待审核,2审核通过,3审核不通过"},"kycAuditRemark":{"type":"string","description":"注册KYC审核备注,审核拒绝不为空"},"kycStatus":{"type":"integer","format":"int32","description":"KYC状态"},"kycRemark":{"type":"string","description":"KYC状态名称"},"accountList":{"type":"object","description":"交易账户列表","properties":{}},"accountRemark":{"type":"string","description":"客户是否有交易账户备注"},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要"},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在"},"email":{"type":"string","description":"邮箱"},"phone":{"type":"string","description":"手机"},"phoneArea":{"type":"string","description":"手机区号"},"name":{"type":"string","description":"姓名"},"country":{"type":"string","description":"国家"},"type":{"type":"integer","format":"int32","description":"组类型 <0真实，1模拟，2游客>"},"deposit":{"type":"integer","format":"int32","description":"可存款,1可存款"},"withdraw":{"type":"integer","format":"int32","description":"可取款,1可取款"},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加"},"activateStatus":{"type":"integer","format":"int32","description":"激活状态，0未激活，1已激活"},"activateTime":{"type":"integer","format":"int64","description":"激活时间"},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启"},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号"},"source":{"type":"string","description":"来源"},"thirdLoginSource":{"type":"string","description":"第三方登录源 telegram"},"thirdUserId":{"type":"string","description":"第三方userId"},"idCard":{"type":"string","description":"证件号码"},"idCardType":{"type":"string","description":"证件类型"},"thirdIntactMsg":{"type":"string","description":"第三方登录完整数据"},"firstName":{"type":"string","description":"名"},"lastName":{"type":"string","description":"姓"},"isFund":{"type":"integer","format":"int32","description":"是否为基金经理，1是，默认0否"},"assertPassStatus":{"type":"string","description":"设置资金密码提醒标志，1需要设置密码，2不需要"},"googleId":{"type":"integer","format":"int64","description":"是否开启MFA，大于0，开启，其余未开启"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"loginTime":{"type":"integer","format":"int64","description":"登陆时间"},"createTime":{"type":"integer","format":"int64","description":"创建时间"},"relationCustomerId":{"type":"integer","format":"int64","description":"关联账户id"},"companyType":{"type":"string","description":"公司类型"},"registerSource":{"type":"integer","format":"int32","description":"注册来源"},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id"},"registerTime":{"type":"integer","format":"int64","description":"注册时间"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## 三方注册（不需要手机，邮箱）

> version=0.0.1\
> bizType=customer.app.CustomerThirdLoginService.socialRegister\
> 游客可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户接口/社交账号登录"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/third/login/customer.app.CustomerThirdLoginService.socialRegister":{"post":{"summary":"三方注册（不需要手机，邮箱）","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerThirdLoginService.socialRegister\n游客可访问","operationId":"register","tags":["客户接口/社交账号登录"],"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":"国家code"},"thirdSource":{"type":"string","description":"第三方源 telegram"},"userId":{"type":"string","description":"第三方userId"},"authToken":{"type":"string","description":"三方授权凭证","minLength":64,"maxLength":64},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"注册来源:1=移动端web：H5，2=pcweb：PC_Web，3=系统&后台注册：System，4=安卓原生app：Android，5=苹果原生app：iOS，6=鸿蒙OS：HOS，7=pc windows客户端：PC_Win,8=pc mac客户端：PC_Mac，9=不属于以上的：其他"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组ID"},"utmSource":{"type":"string","description":"广告来源(开户链接参数source)"},"utmMedium":{"type":"string","description":"广告媒介(开户链接参数medium)"},"utmCampaign":{"type":"string","description":"广告系列(开户链接参数campaign)"},"utmContent":{"type":"string","description":"广告组(开户链接参数content)"},"utmTerm":{"type":"string","description":"关键词(开户链接参数term)"},"lang":{"type":"string","description":"语言信息"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号","maxLength":45},"thirdServerSource":{"type":"string","description":"第三方系统来源，如：代理=agent","maxLength":10},"registerDevice":{"type":"string","description":"注册的设备型号"},"token":{"type":"string","description":"登录票据"}},"required":["country","thirdSource","userId","registerSource","authToken"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"模块标识码"},"code":{"type":"string","description":"状态返回码"},"msg":{"type":"string","description":"状态描述"},"tm":{"type":"integer","format":"int64","description":"处理时长（毫秒）"},"trace":{"type":"string","description":"跟踪码"},"msgParams":{"type":"string","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"客户账号"},"list":{"type":"array","description":"KYC认证列表信息","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"公司ID"},"ext1":{"type":"string","description":"扩展字段(无用)"},"ext2":{"type":"string","description":"扩展字段(无用)"},"email":{"type":"string","description":"邮箱"},"phone":{"type":"string","description":"手机"},"phoneArea":{"type":"string","description":"手机区号"},"name":{"type":"string","description":"姓名"},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要"},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组"},"country":{"type":"string","description":"国家"},"id":{"type":"integer","format":"int64","description":"客户id"},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加"},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号"},"source":{"type":"string","description":"来源"},"capitalInStatus":{"type":"integer","format":"int32","description":"入金状态:1已入金、2未入金"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"companyType":{"type":"string","description":"公司类型"},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id"},"registerTime":{"type":"integer","format":"int64","description":"注册时间"},"apiCheckSwitch":{"type":"boolean","description":"API 校验开关。true-已打开校验"},"apiCheckRule":{"type":"string","description":"API 校验规则。1-邮件；2-短信；3-谷歌NFA；同时启用多个校验，以,分割。"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"等级code"},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 "},"levelName":{"type":"string","description":"等级名称"},"pathName":{"type":"string","description":"KYC路径名称"},"pathCode":{"type":"string","description":"KYC路径code"},"elementList":{"type":"array","description":"KYC信息列表","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC元素code"},"elementName":{"type":"string","description":"KYC元素名称"},"showType":{"type":"string","description":"KYC元素显示类型"},"extend":{"type":"string","description":"KYC元素扩展属性"},"elementValue":{"type":"string","description":"KYC元素值"},"elementValueInputGroup":{"type":"string","description":"KYC元素值，组合"},"elementCodeInputGroup":{"type":"string","description":"KYC元素code，组合"}}}}}}
```


---

# 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-cn.multimarkets.org/client-api/geng-duo-.../ke-hu-jie-kou-she-jiao-zhang-hao-deng-lu.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.