Login

Trading client login authorization

Introduction

This interface is used to log in to the trading system when customizing the client, and to subscribe to quotes and place trading orders.

Interface

Email/Mobile phone number login

Login

version=0.0.1 bizType=customer.app.CustomerWebApiService.login Guest Accessible

POSThttps://prewppc-3.cmfbl.com/api/login/customer.app.CustomerWebApiService.login

Header parameters

Body

application/json

type*integer

Registration and Login Methods: 1 Email, 2 Phone Number, 3 Customer Account

phoneAreastring

Phone Area Code; Required field when type is 2: Phone Number

loginName*string

Account: Email/Phone Number

device*integer

Login Device: 1=Mobile Web: H5, 2=PC Web: PC_Web, 3=System & Backend Registration: System, 4=Android Native App: Android, 5=iOS Native App: iOS, 6=HarmonyOS: HOS, 7=PC Windows Client: PC_Win, 8=PC Mac Client: PC_Mac, 9=Others

isThird*boolean

Is it a third party

verifyCodestring

Verification code

sendTokenstring

Verification code sending ticket

loginPwdstring

Login password

bindThirdUserIdstring

Bind third-party userId

thirdSourcestring

Third-Party Sources: google, facebook, twitter…

googleCodestring

Google Verification Code

Response

200

Success

Body

application/json

bizCodestring

Module identifier code

codestring

Status return code

msgstring

Status description

tminteger (int64)

Processing time (milliseconds)

tracestring

Tracking code

msgParamsstring

Placeholder parameter string in return description, multiple parameters separated by commas

dataobject

okboolean

failboolean

Request

JavaScriptCurlPython

const response = await fetch('https://prewppc-3.cmfbl.com/api/login/customer.app.CustomerWebApiService.login', {
    method: 'POST',
    headers: {
      "version": "text",
      "companyId": "text",
      "trace": "text",
      "lang": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "type": 2,
      "device": 1,
      "loginName": "13429837442",
      "isThird": false,
      "thirdSource": "",
      "bindThirdUserId": "",
      "loginPwd": "dc483e80a7a0bd9ef71d8cf973673924"
    }),
});
const data = await response.json();

Response

200

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

Login with social account

Get Third-Party Login Configuration Information

version=0.0.1 bizType=customer.app.CustomerThirdLoginService.config Guest Accessible

POSThttps://prewppc-3.cmfbl.com/api/global/customer.app.CustomerThirdLoginService.config

Header parameters

Body

application/json

thirdSourcestring

Third-Party Sources: google, facebook, twitter, telegram, apple, metamask

Response

200

Success

Body

application/json

code*string

Status Return Code, code=0 indicates current request operation success, other codes handle exceptions

msg*string

Status description

bizCode*string

Module identifier code

tm*integer (int64)

Processing time (milliseconds)

trace*string

Tracking code

msgParams*string

Placeholder parameter string in return description, multiple parameters separated by commas

data*object

Data Body

Request

JavaScriptCurlPython

const response = await fetch('https://prewppc-3.cmfbl.com/api/global/customer.app.CustomerThirdLoginService.config', {
    method: 'POST',
    headers: {
      "version": "text",
      "companyId": "text",
      "trace": "text",
      "lang": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "code": "text",
  "msg": "text",
  "bizCode": "text",
  "tm": 0,
  "trace": "text",
  "msgParams": "text",
  "data": {
    "thirdSource": "text",
    "clientId": "text",
    "developerAccount": "text"
  }
}

Google Third-party Login Verification

version=0.0.1 bizType=customer.app.CustomerThirdLoginService.googleVerify Accessible after login

POSThttps://prewppc-3.cmfbl.com/api/h/com.cats.customer.api.app.CustomerThirdLoginService/googleVerify

Body

application/json

idTokenToken verification required for web

accessTokenToken verification required for app

Response

200

Success

Body

application/json

code*System General Return Code

0-Success, other exceptions

msg*Return information

bizCode*Module identifier code

tm*Processing time (milliseconds)

trace*Global link flag information

data*object

msgParams*Placeholder parameter string in return description, multiple parameters separated by commas

Request

JavaScriptCurlPython

const response = await fetch('https://prewppc-3.cmfbl.com/api/h/com.cats.customer.api.app.CustomerThirdLoginService/googleVerify', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "code": "text",
  "msg": "text",
  "bizCode": "text",
  "tm": 0,
  "trace": "text",
  "data": {
    "thirdSource": "text",
    "result": false,
    "phone": "text",
    "action": "text",
    "failReason": "text",
    "userId": "text",
    "email": "text",
    "token": "text"
  },
  "msgParams": "text"
}