# 客户服务相关

## 检测客户信息是否存在

> version=0.0.1\
> bizType=customer.app.CustomerWebApiService.checkCustomerExist

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.app.CustomerWebApiService.checkCustomerExist":{"post":{"summary":"检测客户信息是否存在","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.checkCustomerExist","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"integer","description":"注册登录方式：1邮箱，2手机号码，3客户账号"},"loginName":{"type":"string","description":"账号：邮箱/手机号码"},"phoneArea":{"type":"string","description":"手机区号，区号默认为+86"},"emailArea":{"type":"string","description":"邮箱区号，区号默认为+86"}},"required":["type","loginName"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","title":"模块标识码","description":"模块标识码"},"code":{"type":"string","title":"状态返回码","description":"状态返回码"},"msg":{"type":"string","title":"状态描述","description":"状态描述"},"tm":{"type":"string","title":"处理时长（毫秒）","description":"处理时长（毫秒）"},"trace":{"type":"string","title":"跟踪码","description":"跟踪码"},"msgParams":{"type":"string","title":"返回描述中占位符参数串，多个参数间以,分割","description":"返回描述中占位符参数串，多个参数间以,分割"},"data":{"type":"integer","title":"1已存在,2不存在","description":"1已存在,2不存在"}},"required":["bizCode","code","tm"]}}},"headers":{}}}}}}}
```

## 客户注册

> \`\`\`\
> 公司默认客户组资产列表示例：\*通过前端H5/PCUI数据提供\*\
> "tradeTypeCurrencyList":\
>  \[\
>     {\
>       "allCurrency": "USDT",\
>       "tradeType": "1",\
>       "isWallet": "",\
>       "alias": "",\
>       "id": "1",\
>       "name": "合约全仓"\
>     },\
>     {\
>       "allCurrency": "USDT",\
>       "tradeType": "2",\
>       "isWallet": "",\
>       "alias": "",\
>       "id": "2",\
>       "name": "合约逐仓"\
>     },\
>     {\
>       "allCurrency": "USDT,USD,BTC,SAND,LINK,AAVE,DOGE,BCH,ETH,BNB,SOL,AVAX,SHIB,UNI,DOT,XRP,ADA,FIL,V10",\
>       "tradeType": "3",\
>       "isWallet": "",\
>       "alias": "",\
>       "id": "3",\
>       "name": "杠杆"\
>     },\
>     {\
>       "allCurrency": \
>       "USDT,BTC,LINK,ETH,SAND,USD,REEF,ADA,AAVE,DOT,ARX4,BNB,DOGE,ARX10,V10,qa001,qa002,M10,XRP,SHIB,EOS,XEC,FIL,FFT,NFT,QA003,QA004,QA005,QA006,QA007,QA008",\
>       "tradeType": "5",\
>       "isWallet": "",\
>       "alias": "",\
>       "id": "5",\
>       "name": "现货"\
>     }\
>   ]\
> \`\`\`\
> \`\`\`\
> 邮箱注册示例：\*登录密码(pwd)MD5加密\*\
> {\
> &#x20; "email": "<16612339304927@qq.com>",\
> &#x20; "emailArea": "+86",\
> &#x20; "pwd": "dc483e80a7a0bd9ef71d8cf973673924",\
> &#x20; "country": "CN",\
> &#x20; "customerGroupId": 1,\
> &#x20; "registerSource": 1,\
> &#x20; "tradeTypeCurrencyList": \[...]\
> }\
> \`\`\`\
> \`\`\`\
> 手机注册示例：\*登录密码(pwd)MD5加密\*\
> {\
> &#x20; "phone": "15167651757",\
> &#x20; "country": "CN",\
> &#x20; "customerGroupId": 1,\
> &#x20; "registerSource": 1,\
> &#x20; "tradeTypeCurrencyList": \[...],\
> &#x20; "phoneArea": "+86",\
> &#x20; "pwd": "dc483e80a7a0bd9ef71d8cf973673924"\
> }\
> \`\`\`

````json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.addCusAndOpenAccountAndKyc":{"post":{"summary":"客户注册","deprecated":false,"description":"```\n公司默认客户组资产列表示例：*通过前端H5/PCUI数据提供*\n\"tradeTypeCurrencyList\":\n [\n    {\n      \"allCurrency\": \"USDT\",\n      \"tradeType\": \"1\",\n      \"isWallet\": \"\",\n      \"alias\": \"\",\n      \"id\": \"1\",\n      \"name\": \"合约全仓\"\n    },\n    {\n      \"allCurrency\": \"USDT\",\n      \"tradeType\": \"2\",\n      \"isWallet\": \"\",\n      \"alias\": \"\",\n      \"id\": \"2\",\n      \"name\": \"合约逐仓\"\n    },\n    {\n      \"allCurrency\": \"USDT,USD,BTC,SAND,LINK,AAVE,DOGE,BCH,ETH,BNB,SOL,AVAX,SHIB,UNI,DOT,XRP,ADA,FIL,V10\",\n      \"tradeType\": \"3\",\n      \"isWallet\": \"\",\n      \"alias\": \"\",\n      \"id\": \"3\",\n      \"name\": \"杠杆\"\n    },\n    {\n      \"allCurrency\": \n      \"USDT,BTC,LINK,ETH,SAND,USD,REEF,ADA,AAVE,DOT,ARX4,BNB,DOGE,ARX10,V10,qa001,qa002,M10,XRP,SHIB,EOS,XEC,FIL,FFT,NFT,QA003,QA004,QA005,QA006,QA007,QA008\",\n      \"tradeType\": \"5\",\n      \"isWallet\": \"\",\n      \"alias\": \"\",\n      \"id\": \"5\",\n      \"name\": \"现货\"\n    }\n  ]\n```\n```\n邮箱注册示例：*登录密码(pwd)MD5加密*\n{\n  \"email\": \"16612339304927@qq.com\",\n  \"emailArea\": \"+86\",\n  \"pwd\": \"dc483e80a7a0bd9ef71d8cf973673924\",\n  \"country\": \"CN\",\n  \"customerGroupId\": 1,\n  \"registerSource\": 1,\n  \"tradeTypeCurrencyList\": [...]\n}\n```\n```\n手机注册示例：*登录密码(pwd)MD5加密*\n{\n  \"phone\": \"15167651757\",\n  \"country\": \"CN\",\n  \"customerGroupId\": 1,\n  \"registerSource\": 1,\n  \"tradeTypeCurrencyList\": [...],\n  \"phoneArea\": \"+86\",\n  \"pwd\": \"dc483e80a7a0bd9ef71d8cf973673924\"\n}\n```","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string","description":"账号：手机号码"},"email":{"type":"string","description":"账号：邮箱"},"phoneArea":{"type":"string","description":"手机区号，区号默认为+86"},"emailArea":{"type":"string","description":"邮箱区号，区号默认为+86"},"pwd":{"type":"string","description":"登录密码，MD5加密、a123456"},"country":{"type":"string","description":"国家:CN=中国"},"registerSource":{"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=不属于以上的：其他"},"customerGroupId":{"type":"number","description":"客户组ID:1=默认客户组; customerFroupId与tradeTypeCurrencyList相互对应"},"remark":{"type":"string","description":"备注"},"registerDevice":{"type":"string","description":"注册的设备型号"},"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)"},"tradeTypeCurrencyList":{"type":"array","items":{"type":"object","properties":{"allCurrency":{"type":"string","description":"资产币种，多个资产以,拼接"},"tradeType":{"type":"string","description":"玩法类型"}},"required":["allCurrency","tradeType"]},"description":"玩法币种集合"}},"required":["phone","country","customerGroupId","registerSource","tradeTypeCurrencyList","pwd"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"系统通用返回码。0-成功，其他异常"},"msg":{"type":"string","description":"返回信息"},"bizCode":{"type":"string","description":"模块标识码"},"tm":{"description":"处理时长（毫秒）","type":"number"},"trace":{"type":"string","description":"全局链路标志信息"},"msgParams":{"description":"返回描述中占位符参数串，多个参数间以,分割","type":"string","nullable":true},"data":{"type":"string","description":"返回结果,客户编号"}},"required":["code","msg","bizCode","tm","trace","msgParams","data"]}}},"headers":{}}}}}}}
````

## 客户基础信息

> version=0.0.1\
> bizType=customer.admin.WhiteCustomerAdminApiService.page

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.page":{"post":{"summary":"客户基础信息","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.WhiteCustomerAdminApiService.page","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"customerNo":{"type":"string","description":"客户编号"},"size":{"type":"number","description":"每页显示多少行，默认20"},"current":{"type":"number","description":"当前页，默认1"}},"required":["customerNo"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"agentCustomerNo":{"type":"string","description":"代理编号","refType":null},"companyId":{"type":"integer","format":"int64","description":"公司","refType":null},"createTime":{"type":"integer","format":"int64","description":"创建时间/申请时间","refType":null},"customerGroupId":{"type":"integer","format":"int64","description":"客户组Id","refType":null},"customerGroupName":{"type":"string","description":"客户组名称","refType":null},"customerNo":{"type":"string","description":"客户账号","refType":null},"customerType":{"type":"integer","format":"int32","description":"客户类型0默认1代理2授信3活动结算","refType":null},"email":{"type":"string","description":"邮箱","refType":null},"firstAccountActivateTime":{"type":"integer","format":"int64","description":"交易账号首次激活时间","refType":null},"firstName":{"type":"string","description":"名","refType":null},"id":{"type":"integer","format":"int64","description":"id","refType":null},"idCard":{"type":"string","description":"证件号码","refType":null},"idCardType":{"type":"string","description":"证件类型","refType":null},"lastName":{"type":"string","description":"姓","refType":null},"loginTime":{"type":"integer","format":"int64","description":"登录时间","refType":null},"name":{"type":"string","description":"姓名","refType":null},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 ","refType":null},"phone":{"type":"string","description":"手机","refType":null},"phoneArea":{"type":"string","description":"手机区号","refType":null},"registerSource":{"type":"integer","format":"int32","description":"注册来源","refType":null},"remark":{"type":"string","description":"备注","refType":null},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中","refType":null},"tgUserId":{"type":"string","description":"tgUserId","refType":null},"tgUserName":{"type":"string","description":"tgUserName","refType":null},"thirdAccountNo":{"type":"string","description":"三方账户","refType":null},"thirdLoginSource":{"type":"string","description":"thirdLoginSource","refType":null},"thirdUserId":{"type":"string","description":"thirdUserId","refType":null},"unitId":{"type":"integer","format":"int64","description":"机构id","refType":null},"unitName":{"type":"string","description":"机构名称","refType":null},"updateTime":{"type":"integer","format":"int64","description":"更新时间","refType":null}},"title":"WhiteCustomerAdminPageVO"}}},"headers":{}}}}}}}
```

## 客户详情

> version=0.0.1\
> bizType=customer.admin.WhiteCustomerAdminApiService.detail

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.WhiteCustomerAdminApiService.detail":{"post":{"summary":"客户详情","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.WhiteCustomerAdminApiService.detail","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"鉴权码","required":true,"schema":{"type":"string"}},{"name":"version","in":"header","description":"接口版本号","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"类型信息，baseInfo=基础信息，tradeAccount=交易账户，kyc=kyc信息，allKyc=详情页面kyc信息，bankList=银行卡列表,walletList=钱包地址，otherInfo=其他"},"id":{"type":"string","description":"客户id"},"customerNo":{"type":"string","description":"客户编号"}},"required":["type","id","customerNo"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"accountList":{"type":"object","description":"交易账户列表","refType":null,"properties":{}},"accountRemark":{"type":"string","description":"客户是否有交易账户备注","refType":null},"activateStatus":{"type":"integer","format":"int32","description":"激活状态","refType":null},"activateTime":{"type":"integer","format":"int64","description":"激活时间","refType":null},"address":{"type":"string","description":"通讯地址","refType":null},"apiCheckRule":{"type":"string","description":"API 校验规则。1-邮件；2-短信；3-谷歌NFA；同时启用多个校验，以,分割。","refType":null},"apiCheckSwitch":{"type":"boolean","description":"API 校验开关","refType":null},"assertPassStatus":{"type":"string","description":"设置资金密码提醒标志，1需要设置密码，2不需要","refType":null},"associationCompanyId":{"type":"integer","format":"int64","description":"关联公司Id","refType":null},"companyId":{"type":"integer","format":"int64","description":"公司","refType":null},"companyKycStatus":{"type":"integer","format":"int32","description":"公司KYC开户状态，1开启2未开启","refType":null},"companyType":{"type":"string","description":"公司类型","refType":null},"country":{"type":"string","description":"国家","refType":null},"createTime":{"type":"integer","format":"int64","description":"创建时间","refType":null},"customerAgentMark":{"type":"string","description":"客户代理标示","refType":null},"customerGroupId":{"type":"integer","format":"int64","description":"客户组","refType":null},"customerNo":{"type":"string","description":"客户账号","refType":null},"customerType":{"type":"integer","format":"int32","description":"客户类型0默认1代理2授信3活动结算","refType":null},"deposit":{"type":"integer","format":"int32","description":"可存款,1可存款","refType":null},"earlyWarningLevel":{"type":"object","description":"预警水平","refType":null,"properties":{}},"email":{"type":"string","description":"邮箱","refType":null},"firstName":{"type":"string","description":"名","refType":null},"forceLevel":{"type":"object","description":"强平水平","refType":null,"properties":{}},"googleId":{"type":"integer","format":"int64","description":"是否开启MFA，大于0，开启，其余未开启","refType":null},"id":{"type":"integer","format":"int64","description":"客户id","refType":null},"idCard":{"type":"string","description":"证件号码","refType":null},"idCardType":{"type":"string","description":"证件类型","refType":null},"isFund":{"type":"integer","format":"int32","description":"是否为基金经理，1是，默认0否","refType":null},"kycAuditRemark":{"type":"string","description":"注册KYC审核备注,审核拒绝不为空","refType":null},"kycAuditStatus":{"type":"integer","format":"int32","description":"注册KYC审核状态:0未认证跳转到认证页面,1待审核,2审核通过,3审核不通过","refType":null},"kycRemark":{"type":"string","description":"KYC状态名称","refType":null},"kycStatus":{"type":"integer","format":"int32","description":"KYC状态","refType":null},"lastName":{"type":"string","description":"姓","refType":null},"loginPassStatus":{"type":"string","description":"设置密码提醒标志，1需要设置密码，2不需要","refType":null},"loginTime":{"type":"integer","format":"int64","description":"登陆时间","refType":null},"name":{"type":"string","description":"姓名","refType":null},"openAccountType":{"type":"integer","format":"int32","description":"开户类型：0.个人 1.企业 ","refType":null},"optional":{"type":"integer","format":"int32","description":"自选标志0未添加1已添加","refType":null},"payPassStatus":{"type":"string","description":"支付密码是否存在状态，1不存在，2存在","refType":null},"phone":{"type":"string","description":"手机","refType":null},"phoneArea":{"type":"string","description":"手机区号","refType":null},"postalCode":{"type":"string","description":"邮政编码","refType":null},"registerSource":{"type":"integer","format":"int32","description":"注册来源","refType":null},"registerTime":{"type":"integer","format":"int64","description":"注册时间","refType":null},"relationCustomerId":{"type":"integer","format":"int64","description":"关联账户id","refType":null},"source":{"type":"string","description":"来源","refType":null},"status":{"type":"integer","format":"int32","description":"状态:1正常、2禁用、3删除，4销户，5锁定，6销户中","refType":null},"thirdIntactMsg":{"type":"string","description":"第三方登录完整数据","refType":null},"thirdLoginSource":{"type":"string","description":"第三方登录源 google,facebook,twitter","refType":null},"thirdServerCode":{"type":"string","description":"第三方系统唯一编号","refType":null},"thirdUserId":{"type":"string","description":"第三方userId","refType":null},"type":{"type":"integer","format":"int32","description":"组类型 <0真实，1模拟，2游客>","refType":null},"unitId":{"type":"integer","format":"int64","description":"机构ID","refType":null},"unitName":{"type":"string","description":"机构名称","refType":null},"utmSource":{"type":"string","description":"广告来源","refType":null},"withdraw":{"type":"integer","format":"int32","description":"可取款,1可取款","refType":null},"withdrawLevel":{"type":"object","description":"取款水平","refType":null,"properties":{}}},"title":"CustomerAllInfoVO"}}},"headers":{}}}}}}}
```

## 查询客户组列表

> version=0.0.1\
> bizType=customer.admin.CustomerGroupAdminApiService.groupList\
> B端鉴权之后可访问

```json
{"openapi":"3.0.1","info":{"title":"默认模块","version":"1.0.0"},"tags":[{"name":"客户服务相关"}],"servers":[{"url":"https://pre-api-test.cmfbl.com/openapi-b","description":"PRE环境-公司439"}],"security":[],"paths":{"/customer.admin.CustomerGroupAdminApiService.groupList":{"post":{"summary":"查询客户组列表","deprecated":false,"description":"version=0.0.1\nbizType=customer.admin.CustomerGroupAdminApiService.groupList\nB端鉴权之后可访问","tags":["客户服务相关"],"parameters":[{"name":"trace","in":"header","description":"全局链路唯一标志","required":true,"schema":{"type":"string"}},{"name":"companyId","in":"header","description":"公司ID","required":true,"schema":{"type":"string"}},{"name":"token","in":"header","description":"B端鉴权后token","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":{"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":"array","items":{"$ref":"#/components/schemas/CustomerGroupBizVO"},"description":"数据体"},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"CustomerGroupBizVO":{"type":"object","properties":{"name":{"type":"string","description":"组名称"},"id":{"type":"integer","format":"int64","description":"id"},"type":{"type":"integer","format":"int32","description":"组类型"},"openAccountType":{"type":"integer","format":"int32","description":"开户组类型,1是2否"},"tradeType":{"type":"integer","format":"int64","description":"玩法Id"},"assets":{"type":"string","description":"资产信息"}}}}}}
```


---

# 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/manager-api/geng-duo-.../ke-hu-fu-wu-xiang-guan.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.