# 客户接口/登录授权

## 登录

> version=0.0.1\
> bizType=customer.app.CustomerWebApiService.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":{"/login/customer.app.CustomerWebApiService.login":{"post":{"summary":"登录","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.login\n游客可访问","tags":["客户接口/登录授权"],"parameters":[{"name":"version","in":"header","description":"版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID，通过环境变量获取","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"随机跟踪码UUID","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"语言","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"integer","description":"注册登录方式：1邮箱，2手机号码，3客户账号"},"phoneArea":{"type":"string","description":"手机区号；类型为2：手机号码时该字段必填"},"loginName":{"type":"string","description":"账号：邮箱/手机号码"},"device":{"type":"integer","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=不属于以上的：其他"},"isThird":{"type":"boolean","description":"是否第三方"},"verifyCode":{"type":"string","description":"验证码"},"sendToken":{"type":"string","description":"验证码发送票据"},"loginPwd":{"type":"string","description":"登录密码"},"bindThirdUserId":{"type":"string","description":"绑定第三方userId"},"thirdSource":{"type":"string","description":"第三方源 google,facebook,twitter…"},"googleCode":{"type":"string","description":"谷歌验证码"}},"required":["type","device","loginName","isThird"]}}}},"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，保持一致： 1=未验证，2=审核中，3=认证失败，4=已认证，-1=’’"},"kycRemark":{"type":"string","description":"KYC状态名称 (1, \"未验证\", \"配置了KYC，但KYC都未提交过\"),(2, \"审核中\", \"配置了KYC，且KYC正在审核中，至少一个等级在审核中\"),(3, \"认证失败\", \"配置了KYC，且提交的KYC被拒绝，至少一个等级被拒绝\"),(4, \"已认证\", \"配置了KYC，且全部都已认证通过\"),(-1, \"\", \"配置了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":"注册时间"},"token":{"type":"string","description":"鉴权token"},"customerAgentMark":{"type":"string","description":"客户代理标示"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}}}
```

## 客户注册

> version=0.0.1\
> bizType=customer.app.CustomerWebApiService.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":{"/register/customer.app.CustomerWebApiService.register":{"post":{"summary":"客户注册","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.register\n游客可访问","operationId":"register","tags":["客户接口/登录授权"],"parameters":[{"name":"version","in":"header","description":"版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID，通过环境变量获取","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"随机跟踪码UUID","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"语言","required":true,"schema":{"type":"string"}},{"name":"X-Forwarded-For","in":"header","description":"","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"国家"},"lang":{"type":"string","description":"语言信息，默认en-US"},"loginName":{"type":"string","description":"账号：邮箱/手机号码，与type配合使用"},"phoneArea":{"type":"string","description":"手机区号，与注册方式配合使用，默认+86"},"type":{"type":"integer","format":"int32","description":"注册方式：1邮箱，2手机号码","minimum":1,"maximum":3},"registerDevice":{"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)"},"customerGroupId":{"type":"integer","format":"int64","description":"客户组ID"},"tradeTypeCurrencyList":{"type":"array","description":"玩法币种信息","items":{"type":"object","properties":{"allCurrency":{"type":"string","description":"资产币种信息"},"tradeType":{"type":"string","description":"玩法Id"}}},"maxItems":2147483647,"minItems":1},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 ，默认个人"},"pwd":{"type":"string","description":"密码，MD5加密"},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号"},"thirdServerSource":{"type":"string","description":"第三方系统来源，如：代理=agent"}},"required":["registerSource","type","country","loginName","sendToken","verifyCode"]}}}},"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"},"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":"客户组Id"},"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，组合"}}}}}}
```

## POST /thirdExt/switchAccount

> 真实模拟账户切换

```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":{"/thirdExt/switchAccount":{"post":{"summary":"真实模拟账户切换","deprecated":false,"description":"","tags":["客户接口/登录授权"],"parameters":[{"name":"companyId","in":"header","description":"公司ID，通过环境变量获取","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"随机跟踪码UUID","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"登录token","required":true,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"语言","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{}}}},"headers":{}}}}}}}
```

## 重置模拟账户

> version=0.0.1\
> bizType=customer.app.CustomerDubboApiService.resetAccount

```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.CustomerDubboApiService.resetAccount":{"post":{"summary":"重置模拟账户","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerDubboApiService.resetAccount","tags":["客户接口/登录授权"],"parameters":[{"name":"companyId","in":"header","description":"公司ID，通过环境变量获取","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"随机跟踪码UUID","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"登录token","required":true,"schema":{"type":"string"}},{"name":"lang","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":{}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{}}}},"headers":{}}}}}}}
```

## 获取访问令牌

> /global/thirdExt/randomKey\
> 通过一次临时Token换取最终访问Token

```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/thirdExt/randomKey":{"post":{"summary":"获取访问令牌","deprecated":false,"description":"/global/thirdExt/randomKey\n通过一次临时Token换取最终访问Token","operationId":"getSymbolBaseList","tags":["客户接口/登录授权"],"parameters":[{"name":"companyId","in":"header","description":"公司ID，通过环境变量获取","required":true,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"随机跟踪码UUID","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"登录token","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"语言","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{}}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"string","description":"最终访问Token"},"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":"返回描述中占位符参数串，多个参数间以,分割"},"ok":{"type":"boolean","description":"是否成功"},"fail":{"type":"boolean","description":"是否异常"}},"required":["data"]}}},"headers":{}}}}}}}
```