# 客户接口/登录授权

## 登录

> 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":{}}}}}}}
```


---

# 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-deng-lu-shou-quan.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.