中望帐号
    中望帐号
    • 服务更新记录
    • 接入说明
    • 网关和规范
    • 客户端接入\变更申请
    • 全局返回码
    • 用户一致性
    • 用户消息推送
    • 授权认证
      • 获取服务配置
        GET
      • 获取用户授权code
        GET
      • 使用授权code兑换用户令牌
        POST
      • 刷新令牌
        POST
      • 受信客户端获取令牌
        POST
      • 密码模式获取用户令牌
        POST
    • 用户
      • 获取用户基本信息(OIDC)-不建议使用
        GET
      • 获取用户基本信息
        GET
      • 修改用户基本信息
        POST
      • 修改用户头像
        POST
      • 获取用户详细信息
        GET
      • 修改用户详细信息
        POST
      • 获取用户第三方绑定信息
        GET
      • 获取用户资讯接收设置
        GET
      • 结束会话(退出登录)
        GET
      • 获取客户端配置
        GET
      • 获取用户信息修改次数
        GET
      • 修改帐号安全信息
        GET
      • 获取用户当前IP信息
        GET
      • 发送验证码
        POST
    • 受信客户端接口
      • 用户
        • 获取用户GUID列表
        • 批量查询用户GUID
        • 批量获取用户详细信息
        • 批量获取用户第三方绑定信息
        • 通过第三方登录信息查询用户
        • 创建用户
        • 查询最近的登录记录
        • 增加用户第三方绑定信息
        • 批量修改用户详细信息
      • 企业
        • 刷新企业用户部门
      • 其他
        • 推送服务消息
    • OEM受信客户端
      • OEM授权认证对接说明
      • 获取OEM用户列表
      • 注册OEM用户
      • 更新OEM用户
      • 删除OEM用户
    • 管理后台
      • 用户
        • 获取用户列表
        • 申请导出用户数据
        • 获取导出的用户数据
        • 取消用户数据导出申请
        • 获取数据申请记录
        • 获取数据下载记录
        • 搜索用户
        • 获取用户部门名称链
        • 修改用户详细信息
        • 修改用户安全信息
        • 解绑用户手机号\邮箱\第三方
      • 角色
        • 获取角色组列表
        • 新建角色组
        • 更新角色组
        • 设置角色组管理员
        • 添加用户至角色组
        • 从角色组移除用户
        • 为用户分配可读权限
        • 取消用户可读权限
      • 企业
        • 创建\修改企业
        • 创建\修改企业第三方关联
    • 其他
      • 企微第三方用户关联
      • 企微回调
      • 获取客户端配置
      • 获取RSA公钥

    全局返回码

    授权认证错误返回说明#

    当授权认证相关接口错误时,会返回400,且返回体中有IdentityServer4的默认错误说明
    {
        "error": "简要错误说明"
    }
    常见错误如下:
    error说明
    invalid_client请求中的客户端信息错误,如未注册的客户端、不允许的回调地址等
    invalid_scope当前客户端不允许请求某个scope
    invalid_grant授权错误,如用户授权code错误或失效、PKCE校验失败等
    unauthorized_client客户端未授权,如grant_type错误或客户端密钥错误等

    用户API接口返回说明#

    statuserror说明
    0null请求成功
    40001UserGuidNotFound获取用户GUID失败,例如使用非用户token请求,或参数未传入用户GUID
    40002UserNotFound用户不存在
    40003FoundUserFailed查找用户时错误
    40004RequestInvalid无效请求
    40005UpdateUserFailed更新用户失败,一般为修改用户信息的接口返回的失败
    40006NotFound未找到指定内容
    40007IllegalContent请求包含违规内容(暴力\色情\政治等等)
    50000UnknownError未知错误
    50001EmailAlreadyExist邮箱用户已存在
    50002EmailUnqualified邮箱格式不符合要求
    50003BothEmailAndPhoneUnqualified邮箱和手机均不符合要求
    50004PhoneUnqualified手机格式不符合要求或不受支持
    50005ITCErrorOrNonsupported国别号错误或不支持;或手机号与国别号不匹配
    50006PhoneAlreadyExist手机用户已存在
    50007PasswordUnqualified密码不符合要求
    50008UserNameUnqualified用户名不符合要求
    50009UserNameAlreadyExist用户名已存在
    50010CannotCreateMoreUsers当前OEM客户端用户数量已达上限
    修改于 2022-12-20 03:26:04
    上一页
    客户端接入\变更申请
    下一页
    用户一致性
    Built with