客户服务相关

检测客户信息是否存在

post

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

Header parameters

tracestringRequired

全局链路唯一标志

Example: {{mock_trace}}

companyIdstringRequired

公司ID

Example: {{company}}

versionstringRequired

接口版本号

Example: 0.0.1

Body

application/json

typeintegerRequired

注册登录方式：1邮箱，2手机号码，3客户账号

loginNamestringRequired

账号：邮箱/手机号码

phoneAreastringOptional

手机区号，区号默认为+86

emailAreastringOptional

邮箱区号，区号默认为+86

Responses

200Success

application/json

post

/customer.app.CustomerWebApiService.checkCustomerExist

HTTPcURLJavaScriptPython

POST /openapi-b/customer.app.CustomerWebApiService.checkCustomerExist HTTP/1.1
Host: pre-api-test.cmfbl.com
trace: text
companyId: text
version: text
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "type": 2,
  "loginName": "{{mock_phone}}",
  "protocol": "true",
  "emailArea": "+86",
  "phoneArea": "+86"
}

200Success

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "tm": "text",
  "trace": "text",
  "msgParams": "text",
  "data": 1
}

客户注册

post

公司默认客户组资产列表示例：*通过前端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加密*
{
  "email": "[email protected]",
  "emailArea": "+86",
  "pwd": "dc483e80a7a0bd9ef71d8cf973673924",
  "country": "CN",
  "customerGroupId": 1,
  "registerSource": 1,
  "tradeTypeCurrencyList": [...]
}

手机注册示例：*登录密码(pwd)MD5加密*
{
  "phone": "15167651757",
  "country": "CN",
  "customerGroupId": 1,
  "registerSource": 1,
  "tradeTypeCurrencyList": [...],
  "phoneArea": "+86",
  "pwd": "dc483e80a7a0bd9ef71d8cf973673924"
}

Header parameters

tracestringRequired

全局链路唯一标志

Example: {{mock_trace}}

tokenstringRequired

鉴权码

Example: {{auto_token}}

versionstringRequired

接口版本号

Example: 0.0.1

companyIdstringRequired

公司ID

Example: {{company}}

Body

application/json

phonestringRequired

账号：手机号码

emailstringOptional

账号：邮箱

phoneAreastringOptional

手机区号，区号默认为+86

emailAreastringOptional

邮箱区号，区号默认为+86

pwdstringRequired

登录密码，MD5加密、a123456

countrystringRequired

国家:CN=中国

registerSourceintegerRequired

注册来源: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=不属于以上的：其他

customerGroupIdnumberRequired

客户组ID:1=默认客户组; customerFroupId与tradeTypeCurrencyList相互对应

remarkstringOptional

备注

registerDevicestringOptional

注册的设备型号

utmSourcestringOptional

广告来源(开户链接参数source)

utmMediumstringOptional

广告媒介(开户链接参数medium)

utmCampaignstringOptional

广告系列(开户链接参数campaign)

utmContentstringOptional

广告组(开户链接参数content)

utmTermstringOptional

关键词(开户链接参数term)

Responses

200Success

application/json

post

/customer.admin.WhiteCustomerAdminApiService.addCusAndOpenAccountAndKyc

HTTPcURLJavaScriptPython

POST /openapi-b/customer.admin.WhiteCustomerAdminApiService.addCusAndOpenAccountAndKyc HTTP/1.1
Host: pre-api-test.cmfbl.com
trace: text
token: text
version: text
companyId: text
Content-Type: application/json
Accept: */*
Content-Length: 209

{
  "email": "[email protected]",
  "emailArea": "+86",
  "pwd": "dc483e80a7a0bd9ef71d8cf973673924",
  "country": "CN",
  "customerGroupId": 1,
  "registerSource": 1,
  "tradeTypeCurrencyList": [
    {
      "allCurrency": "USDT",
      "tradeType": "1"
    }
  ]
}

200Success

{
  "msg": "Success",
  "fail": false,
  "trace": "t-h2jv9x-4to64-9mp4wd7-793nv-1661227305",
  "code": "0",
  "data": "86021976",
  "bizCode": "",
  "tm": 236026513,
  "msgParams": null,
  "ok": true
}

客户基础信息

post

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

Header parameters

tracestringRequired

全局链路唯一标志

Example: {{mock_trace}}

tokenstringRequired

鉴权码

Example: {{auto_token}}

versionstringRequired

接口版本号

Example: 0.0.1

companyIdstringRequired

公司ID

Example: {{company}}

Body

application/json

customerNostringRequired

客户编号

sizenumberOptional

每页显示多少行，默认20

currentnumberOptional

当前页，默认1

Responses

200Success

application/json

post

/customer.admin.WhiteCustomerAdminApiService.page

HTTPcURLJavaScriptPython

POST /openapi-b/customer.admin.WhiteCustomerAdminApiService.page HTTP/1.1
Host: pre-api-test.cmfbl.com
trace: text
token: text
version: text
companyId: text
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "customerNo": "86002678",
  "size": 20,
  "current": 1
}

200Success

{
  "bizCode": "",
  "code": "",
  "data": {
    "current": 0,
    "records": [
      {
        "agentCustomerNo": "",
        "companyId": 0,
        "createTime": 0,
        "customerGroupId": 0,
        "customerGroupName": "",
        "customerNo": "",
        "customerType": 0,
        "email": "",
        "firstAccountActivateTime": 0,
        "firstName": "",
        "id": 0,
        "idCard": "",
        "idCardType": "",
        "lastName": "",
        "loginTime": 0,
        "name": "",
        "openAccountType": 0,
        "phone": "",
        "phoneArea": "",
        "registerSource": 0,
        "remark": "",
        "status": 0,
        "tgUserId": "",
        "tgUserName": "",
        "thirdAccountNo": "",
        "thirdLoginSource": "",
        "thirdUserId": "",
        "unitId": 0,
        "unitName": "",
        "updateTime": 0
      }
    ],
    "size": 0,
    "total": 0
  },
  "fail": true,
  "msg": "",
  "msgParams": "",
  "ok": true,
  "tm": 0,
  "trace": ""
}

客户详情

post

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

Header parameters

tracestringRequired

全局链路唯一标志

Example: {{mock_trace}}

tokenstringRequired

鉴权码

Example: {{auto_token}}

versionstringRequired

接口版本号

Example: 0.0.1

companyIdstringRequired

公司ID

Example: {{company}}

Body

application/json

typestringRequired

类型信息，baseInfo=基础信息，tradeAccount=交易账户，kyc=kyc信息，allKyc=详情页面kyc信息，bankList=银行卡列表,walletList=钱包地址，otherInfo=其他

idstringRequired

客户id

customerNostringRequired

客户编号

Responses

200Success

application/json

post

/customer.admin.WhiteCustomerAdminApiService.detail

HTTPcURLJavaScriptPython

POST /openapi-b/customer.admin.WhiteCustomerAdminApiService.detail HTTP/1.1
Host: pre-api-test.cmfbl.com
trace: text
token: text
version: text
companyId: text
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "type": "tradeAccount",
  "id": "{{customerId}}",
  "customerNo": "{{customer}}"
}

200Success

{
  "bizCode": "",
  "code": "",
  "data": {
    "accountList": {},
    "accountRemark": "",
    "activateStatus": 0,
    "activateTime": 0,
    "address": "",
    "apiCheckRule": "",
    "apiCheckSwitch": true,
    "assertPassStatus": "",
    "associationCompanyId": 0,
    "companyId": 0,
    "companyKycStatus": 0,
    "companyType": "",
    "country": "",
    "createTime": 0,
    "customerAgentMark": "",
    "customerGroupId": 0,
    "customerNo": "",
    "customerType": 0,
    "deposit": 0,
    "earlyWarningLevel": {},
    "email": "",
    "firstName": "",
    "forceLevel": {},
    "googleId": 0,
    "id": 0,
    "idCard": "",
    "idCardType": "",
    "isFund": 0,
    "kycAuditRemark": "",
    "kycAuditStatus": 0,
    "kycRemark": "",
    "kycStatus": 0,
    "lastName": "",
    "loginPassStatus": "",
    "loginTime": 0,
    "name": "",
    "openAccountType": 0,
    "optional": 0,
    "payPassStatus": "",
    "phone": "",
    "phoneArea": "",
    "postalCode": "",
    "registerSource": 0,
    "registerTime": 0,
    "relationCustomerId": 0,
    "source": "",
    "status": 0,
    "thirdIntactMsg": "",
    "thirdLoginSource": "",
    "thirdServerCode": "",
    "thirdUserId": "",
    "type": 0,
    "unitId": 0,
    "unitName": "",
    "utmSource": "",
    "withdraw": 0,
    "withdrawLevel": {}
  },
  "fail": true,
  "msg": "",
  "msgParams": "",
  "ok": true,
  "tm": 0,
  "trace": ""
}

查询客户组列表

post

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

Header parameters

tracestringRequired

全局链路唯一标志

Example: {{mock_trace}}

companyIdstringRequired

公司ID

Example: {{company}}

tokenstringRequired

B端鉴权后token

Example: {{auto_token}}

versionstringRequired

接口版本号

Example: 0.0.1

Body

application/json

objectOptional

Responses

200Success

application/json

post

/customer.admin.CustomerGroupAdminApiService.groupList

HTTPcURLJavaScriptPython

POST /openapi-b/customer.admin.CustomerGroupAdminApiService.groupList HTTP/1.1
Host: pre-api-test.cmfbl.com
trace: text
companyId: text
token: text
version: text
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "tradeType": 5,
  "customerNo": "86000020"
}

200Success

{
  "bizCode": "text",
  "code": "text",
  "msg": "text",
  "tm": 1,
  "trace": "text",
  "msgParams": "text",
  "data": [
    {
      "name": "text",
      "id": 1,
      "type": 1,
      "openAccountType": 1,
      "tradeType": 1,
      "assets": "text"
    }
  ],
  "ok": true,
  "fail": true
}