# Customer/Agent

## Query customer list

> version=0.0.1\
> bizType=customer.app.CustomerWebApiService.queryCustomerOfAgentPage\
> Access after login

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Agent"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWebApiService.queryCustomerOfAgentPage":{"post":{"summary":"Query customer list","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.queryCustomerOfAgentPage\nAccess after login","operationId":"applyApi","tags":["Customer/Agent"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"token","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"current":{"type":"integer","description":"Current Page"},"size":{"type":"integer","description":"Number of Items per Page"}},"required":["size","current"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"data":{"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","description":"Primary key id"},"createTime":{"type":"integer","description":"Creation time"},"updateTime":{"type":"integer","description":"Update Time"},"customerGroupId":{"type":"integer","description":"Customer group ID"},"customerGroupName":{"type":"string","description":"Customer Group Name"},"status":{"type":"integer","description":"Customer Status, 1 Normal, 2 Disabled, 3 Deleted, 4 Closed Account, 5 Locked, 6 Closing Account"},"companyId":{"type":"integer","description":"Company ID"},"customerNo":{"type":"string","description":"Client number"},"phone":{"type":"string","description":"Phone Number"},"phoneArea":{"type":"string","description":"Phone area code"},"registerSource":{"type":"integer","description":"Registration source: 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=other"},"unitId":{"type":"integer","description":"Organization ID"},"firstName":{"type":"string","description":"First name"},"lastName":{"type":"string","description":"Last name"},"email":{"type":"string","description":"Email"},"customerType":{"type":"integer","description":"Customer Type 0 Default 1 Agent"}},"required":["id","createTime","updateTime","customerGroupId","customerGroupName","status","companyId","customerNo","phone","phoneArea","registerSource","unitId","firstName","lastName","email","customerType"]},"description":"Data List"},"total":{"type":"integer","description":"Total"},"size":{"type":"integer","description":"Page Size"},"current":{"type":"integer","description":"Current Page"}},"required":["records","total","size","current"],"description":"Paging Data Body"},"fail":{"type":"boolean"},"ok":{"type":"boolean"},"bizCode":{"type":"string","description":"Module identifier code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"}},"required":["code","msg","tm","trace","data","fail","ok"]}}},"headers":{}}}}}}}
```

## Customer registration

> version=0.0.1\
> bizType=customer.app.CustomerWebApiService.registerOfAgentShareLink\
> Accessible to visitors\
> Agent share link, customer registration

```json
{"openapi":"3.0.1","info":{"title":"Default module","version":"1.0.0"},"tags":[{"name":"Customer/Agent"}],"servers":[{"url":"https://prewppc-3.cmfbl.com/api","description":"PRE测试公司439"}],"security":[],"paths":{"/global/customer.app.CustomerWebApiService.registerOfAgentShareLink":{"post":{"summary":"Customer registration","deprecated":false,"description":"version=0.0.1\nbizType=customer.app.CustomerWebApiService.registerOfAgentShareLink\nAccessible to visitors\nAgent share link, customer registration","operationId":"applyApi","tags":["Customer/Agent"],"parameters":[{"name":"companyId","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"lang","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"trace","in":"header","description":"","required":false,"schema":{"type":"string"}},{"name":"version","in":"header","description":"","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"country":{"type":"string","description":"Country"},"lang":{"type":"string","description":"Language information, default en-US"},"phoneArea":{"type":"string","description":"Phone area code","maxLength":15},"loginName":{"type":"string","description":"Account: email/phone number, used in conjunction with type","maxLength":50},"pwd":{"type":"string","description":"Password, MD5 encryption"},"type":{"type":"integer","description":"Registration method: 1=email, 2=phone number","format":"int32","minimum":1,"maximum":2},"registerDevice":{"type":"string","description":"Registered device model"},"registerSource":{"type":"integer","format":"int32","minimum":1,"description":"Registration source: 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=other"},"utmSource":{"type":"string","description":"Advertising source (account opening link parameter source)"},"utmMedium":{"type":"string","description":"Advertising medium (account opening link parameter medium)"},"utmCampaign":{"type":"string","description":"Advertising campaign (account opening link parameter campaign)"},"utmContent":{"type":"string","description":"Advertising group (account opening link parameter content)"},"utmTerm":{"type":"string","description":"Keyword (account opening link parameter term)"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"thirdServerCode":{"type":"string","description":"Unique identifier of third-party system (input agent customer number)"}},"required":["registerSource","type","country","loginName","thirdServerCode"]}}}},"responses":{"200":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"bizCode":{"type":"string","description":"Module identifier code"},"code":{"type":"string","description":"Status return code"},"msg":{"type":"string","description":"Status description"},"tm":{"type":"integer","format":"int64","description":"Processing time (milliseconds)"},"trace":{"type":"string","description":"Tracking code"},"msgParams":{"type":"string","description":"Placeholder parameter string in return description, multiple parameters separated by commas"},"data":{"type":"object","properties":{"customerNo":{"type":"string","description":"Customer account"},"list":{"type":"array","description":"KYC authentication list information","items":{"$ref":"#/components/schemas/KycAuthVO"}},"companyId":{"type":"integer","format":"int64","description":"Company ID"},"email":{"type":"string","description":"Email"},"phone":{"type":"string","description":"Phone"},"phoneArea":{"type":"string","description":"Phone area code"},"name":{"type":"string","description":"Name"},"loginPassStatus":{"type":"string","description":"Set password reminder flag, 1 for password required, 2 for not required"},"payPassStatus":{"type":"string","description":"Payment password existence status, 1 for non-existent, 2 for existent"},"customerGroupId":{"type":"integer","format":"int64","description":"Client group ID"},"country":{"type":"string","description":"Country"},"id":{"type":"integer","format":"int64","description":"Customer ID"},"optional":{"type":"integer","format":"int32","description":"Customized flag 0 not added 1 added"},"companyKycStatus":{"type":"integer","format":"int32","description":"Company KYC account opening status, 1 for opened, 2 for not opened"},"thirdServerCode":{"type":"string","description":"Unique identifier from third-party system"},"source":{"type":"string","description":"Source"},"capitalInStatus":{"type":"integer","format":"int32","description":"Deposit status: 1. Deposited, 2. Not deposited"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"companyType":{"type":"string","description":"Company type"},"associationCompanyId":{"type":"integer","format":"int64","description":"Associated company Id"},"registerTime":{"type":"integer","format":"int64","description":"Registration Time"}}},"ok":{"type":"boolean"},"fail":{"type":"boolean"}}}}},"headers":{}}}}}},"components":{"schemas":{"KycAuthVO":{"type":"object","properties":{"levelCode":{"type":"string","description":"Level Code"},"openAccountType":{"type":"integer","format":"int32","description":"Account type: 0. Individual 1. Enterprise "},"levelName":{"type":"string","description":"Level Name"},"pathName":{"type":"string","description":"KYC Path Name"},"pathCode":{"type":"string","description":"KYC Path Code"},"elementList":{"type":"array","description":"KYC Information List","items":{"$ref":"#/components/schemas/KycAuthElementVO"}}}},"KycAuthElementVO":{"type":"object","properties":{"elementCode":{"type":"string","description":"KYC element code"},"elementName":{"type":"string","description":"KYC element name"},"showType":{"type":"string","description":"KYC element display type"},"extend":{"type":"string","description":"KYC element extended attribute"},"elementValue":{"type":"string","description":"KYC element value"},"elementValueInputGroup":{"type":"string","description":"KYC element value, combination"},"elementCodeInputGroup":{"type":"string","description":"KYC element code, combination"}}}}}}
```