中望帐号
    中望帐号
    • 服务更新记录
    • 接入说明
    • 网关和规范
    • 客户端接入\变更申请
    • 全局返回码
    • 用户一致性
    • 用户消息推送
    • 授权认证
      • 获取服务配置
        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公钥

    网关和规范

    网关#

    环境网关地址说明
    开发环境https://developaccounts.zwsoft.cn与测试服共用数据,发放的token与测试服一致。取消了跨域限制,允许无证书的客户端请求,使各服务开发人员在开发过程中能够使其本地电脑运行的服务获取token,如使用 http://localhost:8080 请求相关接口
    测试环境https://testaccounts.zwsoft.cn独立于正式环境的测试用户数据,可供各服务进行测试
    正式环境https://accounts.zwsoft.cn正式环境网关
    海外正式环境https://auth.zwsoft.com海外正式环境网关

    访问频率限制#

    默认每个IP地址6秒内最大160次访问

    语言和国家地区代号#

    某些接口需要传入语言代号或国家地区代号,应按标准传递或返回:
    国家地区代号使用ISO-3166标准,格式:{2位大写国家地区代号},如CN
    语言代号格式为:{2位小写语言代号}-{2位大写国家地区代号},其中{2位小写语言代号}使用ISO-639标准,如zh-CN

    用户安全信息变更#

    另见:用户消息推送

    安全戳#

    用户在操作安全设置(修改手机号、邮箱、密码、注销等),或通过其他方式要求所有已登录中望统一账号的客户端退出登录时,用户信息中的securityStamp将变更,检测到该值变更后,建议退出当前登录态,清除用户access_token和refresh_token。

    账号注销完成#

    用户账号注销完成后,统一账号不再保留用户的数据
    当使用用户令牌获取用户信息时,接口将返回404,且错误信息为:
    {
      "status": 40002,
      "error": "UserNotFound",
      "message": "User Not Found",
      "data": null
    }
    当使用受信客户端令牌批量获取用户信息时,接口将返回200,但返回数据中无该用户信息
    修改于 2024-07-08 03:58:05
    上一页
    接入说明
    下一页
    客户端接入\变更申请
    Built with