QiWe开放平台
企微官网企微报价控制台
企微官网企微报价控制台
    • 开发指南
      • 开发前必读
      • 接入流程
      • 消息订阅
      • 消息回调内容说明
      • 更新日志
    • 实例管理
      • 创建设备
        POST
      • 恢复实例
        POST
      • 停止实例
        POST
      • 设置回调地址
        POST
    • 登陆模块
      • 二维码-获取
        POST
      • 二维码-检测
        POST
      • 二维码-code验证
        POST
      • 用户登录
        POST
      • 用户状态
        POST
    • 用户模块
      • 生成二维码
        POST
      • 获取个人信息
        POST
      • 更新个人信息
        POST
      • 查询企业信息
        POST
      • 注销
        POST
      • 个人收藏-分页
        POST
      • 个人收藏-添加GIF表情
        POST
    • 联系人模块
      • 基本说明
      • 联系人详情-批量
        POST
      • 外部联系人分页
        POST
      • 内部联系人分页
        POST
      • 联系人搜索
        POST
      • 添加个微
        POST
      • 添加企微
        POST
      • 添加群成员好友
        POST
      • 添加企微名片
        POST
      • 添加删除联系人
        POST
      • 同意申请
        POST
      • 个微联系人信息-更新
        POST
      • 企微联系人信息-更新
        POST
      • 删除联系人
        POST
      • OpenID
        POST
    • 群模块
      • 群分页
      • 群详情-批量
      • 创建群
      • 修改群名称
      • 修改群备注
      • 修改群内昵称
      • 邀请/添加成员
      • 移除成员
      • 群二维码
      • 修改群公告
      • 添加群管理员
      • 取消群管理员
      • 退群
      • 转让群主
      • 群解散
      • OpenID
      • 开启群改名
      • 开启群邀请确认
      • 接受群邀请-By链接
    • 会话模块
      • 会话分页
      • 会话组-编辑
      • 会话组-查询
    • 云存储CDN模块
      • 文件上传-异步
      • 文件上传
      • 文件上传-URL
      • 企微文件下载
      • 企微文件下载(异步)
      • 企微大文件下载(异步)
      • 个微文件下载
      • 文件CDN转URL
      • 个微文件异步下载
    • 消息模块
      • 发送消息
      • 发送纯文本消息
      • 发送混合文本消息
      • 发送图片消息
      • 发送GIF表情消息
      • 发送视频消息
      • 发送文件消息
      • 发送语音消息
      • 发送链接消息
      • 发送小程序消息
      • 发送名片消息
      • 发送视频号消息
      • 发送定位消息
      • 撤回消息
      • 修改消息状态
      • 群消息置顶-列表
      • 群消息置顶-添加
      • 群消息置顶-移除
      • 群发消息
      • 群发消息-状态查询
      • 群发消息-规则查询
      • 同步历史消息分页
    • 朋友圈模块
      • 列表分页
      • 列表分页
      • 获取详情-批量
      • 文件上传
      • 发送朋友圈
      • 删除朋友圈
      • 点赞/取消赞
      • 评论/追评
      • 评论删除
    • 标签模块
      • 列表分页
      • 个人标签-增删改
      • 客户标签-增删
    • 数据模型
      • 响应成功
      • GUID请求
    企微官网企微报价控制台
    企微官网企微报价控制台

    登陆模块

    术语说明#

    手机端授权:其它端登录时,手机端会弹出pc/ipad端登录的确认弹层。
    手机端取消授权:手机端操作,强制退出pc/ipad端退出登录
    二次认证:即为code验证码校验。当pc/ipad登录时,需要手机端的6位code码辅助登录

    登录类型#

    目前登录有3种情况:
    1、免扫码登录:直接登录成功。(手机端授权期间内)
    2、扫码登录:需要先扫码,然后在手机端确实登录(老设备上+无手机端授权)
    3、扫码+验证码登录:先扫码,再6位验证码校验登录(新设备会出现)
    1.
    客户端应该通过轮询、或者http/mqtt回调,一直检查登录状态,根据不同的状态来决定那种登录方式。
    2.
    如何感知手机端是否授权?一是通过手机端强制退出pc/ipad的回调信息;二是直接尝试免扫码登录,失败即为未授权

    登录状态#

    1、服务端不保证账号一直维持在线状态(如手机端取消授权、其它端顶号等)
    2、调用方需要根据自身业务,在代码内自行设计可用、及时和稳定的策略来保证账号的持续在线
    3、调用方可定时轮询账号状态查询API, 当响应超时或者其它异常时,及时运维通知,并在代码内操作手动恢复账号状态
    4、恢复账号操作API:停止实例->恢复实例-> IF (自动登录失败)手动介入扫码登录 -> ......
    5、当账号离线后,服务端会自动尝试恢复登录一次,但是不保证登录一定成功

    登陆流程图#

    1.
    其中若配置mqtt则会有相应回调通知。
    2.
    另外,如果不想通过回调对接流程,亦可轮询状态检测/login/checkLogin来接入登陆流程
    修改于 2025-09-02 09:48:17
    上一页
    设置回调地址
    下一页
    二维码-获取
    Built with