用户相关

用户登录/登出和用户信息等相关接口

用户密码登录

手机号密码登录

post

请求体

application/json

appCodestring可选

chinabim服务code为CHINABIM

passwdstring必填

密码登录时必传

Example: PHOND_AND_PWD

phonestring必填

手机号

smsCodestring必填

短信登录时必传

Example: 12345

validateIdstring必填

短信登录时必传

Example: 12345

wxCodestring必填

微信登录Code

Example: 12345

响应

200

OK

*/*

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post

/user/loginByPwd

HTTPcURLJavaScriptPython

POST /v3/user/loginByPwd HTTP/1.1
Host: openapi.ciip.com
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "appCode": "text",
  "passwd": "PHOND_AND_PWD",
  "phone": "text",
  "smsCode": 12345,
  "validateId": 12345,
  "wxCode": 12345
}

{
  "body": {
    "category": 1,
    "cid": "text",
    "createDate": "2026-01-25T07:55:50.780Z",
    "headshot": "text",
    "name": "text",
    "token": "text"
  },
  "head": {
    "cost": 1,
    "retCode": "text",
    "retDesc": "text"
  }
}

手机验证码登录

手机号验证码登录

post

请求体

application/json

appCodestring可选

chinabim服务code为CHINABIM

passwdstring必填

密码登录时必传

Example: PHOND_AND_PWD

phonestring必填

手机号

smsCodestring必填

短信登录时必传

Example: 12345

validateIdstring必填

短信登录时必传

Example: 12345

wxCodestring必填

微信登录Code

Example: 12345

响应

200

OK

*/*

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post

/user/loginByCode

HTTPcURLJavaScriptPython

POST /v3/user/loginByCode HTTP/1.1
Host: openapi.ciip.com
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "appCode": "text",
  "passwd": "PHOND_AND_PWD",
  "phone": "text",
  "smsCode": 12345,
  "validateId": 12345,
  "wxCode": 12345
}

{
  "body": {
    "category": 1,
    "cid": "text",
    "createDate": "2026-01-25T07:55:50.780Z",
    "headshot": "text",
    "name": "text",
    "token": "text"
  },
  "head": {
    "cost": 1,
    "retCode": "text",
    "retDesc": "text"
  }
}

发送验证码

发送登录短信

post

请求体

application/json

appIdstring可选

非必填;默认值CUSTOMER-SERVICE;可选值CHINABIM-SERVICE，ZFX-SERVICE

maxUseTimesinteger · int32可选

最大使用次数

phonestring必填

手机号

typestring必填

短信类型

响应

200

OK

*/*

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post

/user/sendSmsCode

HTTPcURLJavaScriptPython

POST /v3/user/sendSmsCode HTTP/1.1
Host: openapi.ciip.com
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "appId": "text",
  "maxUseTimes": 1,
  "phone": "text",
  "type": "text"
}

{
  "body": {
    "appId": "text",
    "uid": "text",
    "validateId": "text"
  },
  "head": {
    "cost": 1,
    "retCode": "text",
    "retDesc": "text"
  }
}

用户登出

登出

post

请求体

application/json

cidstring必填

登录账号

tokenstring必填

Token

Example: 4cac5d07fbea482594e79ea52776b78f

响应

200

OK

*/*

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post

/user/logout

HTTPcURLJavaScriptPython

POST /v3/user/logout HTTP/1.1
Host: openapi.ciip.com
Content-Type: application/json
Accept: */*
Content-Length: 57

{
  "cid": "text",
  "token": "4cac5d07fbea482594e79ea52776b78f"
}

{
  "body": 1,
  "head": {
    "cost": 1,
    "retCode": "text",
    "retDesc": "text"
  }
}

用户个人信息

根据cid获取用户信息

post

请求体

application/json

cidstring必填

登录账号

customerCidstring必填

员工CID(非登陆账户)

idCardstring可选

身份证号

phonestring必填

手机号

uidstring可选

企业id

响应

200

OK

*/*

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

post

/user/profile

HTTPcURLJavaScriptPython

POST /v3/user/profile HTTP/1.1
Host: openapi.ciip.com
Content-Type: application/json
Accept: */*
Content-Length: 79

{
  "cid": "text",
  "customerCid": "text",
  "idCard": "text",
  "phone": "text",
  "uid": "text"
}

{
  "body": {
    "added": true,
    "address": "text",
    "authFlag": 1,
    "birthday": "2026-01-25T07:55:50.780Z",
    "category": 1,
    "certImages": [
      {
        "ANY_ADDITIONAL_PROPERTY": {}
      }
    ],
    "cid": "text",
    "city": "text",
    "cityId": 1,
    "createDate": "2026-01-25T07:55:50.780Z",
    "flag": 1,
    "gid": "text",
    "groupName": "text",
    "groups": [
      {
        "ANY_ADDITIONAL_PROPERTY": {}
      }
    ],
    "headshot": "text",
    "idNumber": "text",
    "joinDate": "2026-01-25T07:55:50.780Z",
    "lastLoginDate": "2026-01-25T07:55:50.780Z",
    "mail": "text",
    "menuNames": [
      "text"
    ],
    "name": "text",
    "parentCid": "text",
    "parentId": 1,
    "phone": "text",
    "province": "text",
    "provinceId": 1,
    "sex": 1,
    "types": [
      {
        "ANY_ADDITIONAL_PROPERTY": {}
      }
    ]
  },
  "head": {
    "cost": 1,
    "retCode": "text",
    "retDesc": "text"
  }
}