开放文档API

curl -X POST 'https://your-api-host.com/member/create' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-H 'source: pc' \
-d '{
  "userName": "王五",
  "mobile": "13700137000",
  "jobNum": "EMP003"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": { // 用户状态实体类 (具体字段见下表)
    "userId": 20003,
    "userName": "王五",
    "mobile": "13700137000",
    "realName": null,
    "realNameStatus": 0,
    "userStatus": 0
    // 注意：JSON 定义中没有 roles 相关字段，但旧HTML有，此处以JSON为准
  }
}
									

{
  "code": "MEMBER_MOBILE_EXIST", // 示例错误码，具体以实际为准
  "msg": "手机号已被注册",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/infoByCorpId' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "mobile": "13800138000"
}'
									

{
  "code": "200",
  "msg": "成功",
  "data": [ // 用户状态实体类列表
    {
      "userId": 20001,
      "userName": "张三",
      "mobile": "13800138000",
      "userStatus": 0,
      "realName": "张三",
      "realNameStatus": 1
    }
    // ... 其他匹配的用户
  ]
}
									

{
  "code": "MEMBER_NOT_FOUND", // 示例
  "msg": "未查询到匹配的用户",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/infoByUserId' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "userId": 20002
}'
									

{
  "code": "200", // 注意: JSON 定义返回码是字符串"200", 但旧HTML是数字0, 这里遵循JSON
  "msg": "成功",
  "data": { // 用户信息实体类 (具体字段见下表)
    "userId": 20002,
    "userCode": "M0002", // JSON中有, 旧HTML无
    "userName": "李四",
    "mobile": "13800138001",
    "jobNum": "EMP002", // JSON中有, 旧HTML无
    "userStatus": 0,
    "realName": "李四",
    "realNameStatus": 1,
    "identMethod": "face",
    "identSuccessTime": "2023-11-01T10:00:00.000+0800",
    "signPwdSet": 1,
    "createTime": "2023-10-31T15:00:00.000+0800"
    // 省略了旧HTML中有但JSON定义没有的字段，如email, headerImg, identType, identNum, signPwdData, updateTime, wxOpenId, extendInfo, deleted, version, createBy, updateBy
  }
}
									

{
  "code": "MEMBER_NOT_FOUND", // 示例
  "msg": "用户不存在",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/infoByMobileOrName' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: OPERATOR_USER_ID' \
-d '{
  "paramString": "李"
}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": [ // 用户状态实体类列表 (具体字段见下表)
    {
      "userId": 20002,
      "userName": "李四",
      "mobile": "13800138001",
      "realNameStatus": 1
    }
    // ... 可能有更多匹配的用户
  ]
}
									

{
  "code": "PARAM_EMPTY", // 示例
  "msg": "查询参数不能为空",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/memberAuth' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: USER_TO_AUTH_ACCESS_TOKEN' \
-H 'userId: 20002' \
-d '{
  "realName": "李四",
  "identNum": "110101199001011234",
  "signPwd": "666888"
}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": {} // 成功更新通常不返回具体业务数据
}
									

{
  "code": "AUTH_INFO_INVALID", // 示例
  "msg": "实名信息校验失败",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/getPersonalAuthUrl' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: USER_NEEDS_AUTH_URL_TOKEN' \
-H 'userId: 20003' \
-d '{}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": "https://your-system-url.com/auth/personal?token=generated_auth_session_token" // 返回实名认证页面链接
}
									

{
  "code": "USER_ALREADY_AUTHENTICATED", // 示例
  "msg": "用户已实名，无需重复认证",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/fetchAuth' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: USER_NEEDS_FACE_AUTH_TOKEN' \
-H 'userId: 20003' \
-d '{}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": "https://face-recognition-provider.com/verify?session_id=unique_face_session" // 返回人脸识别服务地址/链接
}
									

{
  "code": "FACE_SERVICE_UNAVAILABLE", // 示例
  "msg": "人脸识别服务暂不可用",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/fetchAuth/faceAuth' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: YOUR_ACCESS_TOKEN' \
-H 'userId: REQUESTING_USER_ID' \
-d '{
  "id": "USER_ID_TO_AUTH",
  "authType": "person",
  "channel": "tencent",
  "callbackUrl": "https%3A%2F%2Fyourapp.com%2Fauth%2Fcallback"
}'
									

{
  "code": "200",
  "msg": "success",
  "data": {
    "url": "https://faceid.qq.com/h5/...",
    "corpName": null,
    "isLegal": false,
    "realNameStatus": null
  }
}
									

curl -X POST 'https://your-api-host.com/member/accessAuth' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: ADMIN_ACCESS_TOKEN' \
-H 'userId: 20001' \
-d '{
  "userId": 20002 // 需要授权的李四ID
}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": "https://your-system-url.com/resource/access?temp_token=generated_access_token_for_member_20002" // 返回带令牌的访问链接或仅令牌
}
									

{
  "code": "AUTH_GENERATE_FAILED", // 示例
  "msg": "生成授权凭证失败",
  "data": null
}
									

curl -X POST 'https://your-api-host.com/member/delete' \
-H 'Content-Type: application/json' \
-H 'appId: YOUR_APP_ID' \
-H 'accessToken: ADMIN_ACCESS_TOKEN' \
-H 'userId: 20001' \
-d '{
  "userId": 20003 // 需要删除的王五ID
}'
									

{
  "code": "200", // JSON 定义为字符串
  "msg": "成功",
  "data": {} // 成功删除通常不返回具体数据
}
									

{
  "code": "MEMBER_DELETE_FAILED", // 示例
  "msg": "删除用户失败，可能有关联数据",
  "data": null
}