登录检查

获取二维码后检查用户是否完成扫码登录，在开发登录场景时建议轮循检查，直到反回确定结果。

请求示例：

{
    "r": "f5f577df091f423da46869eaaddd6ef9",
    "token": "dc266b77b568cc851424793cb48ea823",
    "bizType": 5 
}

请求参数说明：

名称	类型	必须	示例值	描述
token	String	是	eaa7c835b5b27c231a8b0c323feb1361	第三方认证的 token，所有的请求需要携带该参数
bizType	Integer	是	5	4表示微信机器人，5表示企微机器人
r	String	是	f5f577df091f423da46869eaaddd6ef9	机器人密钥

响应示例：

用户未扫码时：

响应示例：

{
    "code": "0",
    "messageId": "20210329153418046996953903",
    "msg": "请扫码登录",
    "qrCode": "/9j/4AAQSkZJRgABAQAASABIAAD/4QBARXhpZgAATU0AKgAAAA",
    "robotBizType": 5,
    "robotKey": "f5f577df091f423da46869eaaddd6ef9",
    "siteCode": "wenode_chat_0049",
    "type": "robot.qrcode"
}

响应参数说明：

名称	类型	描述
messageld	String	消息 ID
msg	String	表示还未扫码
qrCode	String	二维码编码数据
robotBizType	Integer	4 表示微信机器人，5 表示企微机器人
robotKey	String	机器人密钥
siteCode	String
type	String

登录成功后：

响应示例：

{
    "code": "0",
    "msg": "OK",
    "robotKey": "f5f577df091f423da46869eaaddd6ef9"
}

响应参数说明：

名称	类型	描述
msg	String	OK表示成功
robotKey	String	机器人密钥

未登录（未获取二维码直接调用登录检查时）：

响应示例：

{
    "code": "926",
    "msg": "未登录"
}

使用错误的企微扫码登录：

响应示例：

{
    "code": "1005",
    "msg": "错误的企微登录"
}

使用错误的企微扫码登录：

响应示例：

{
    "code": "1005",
    "msg": "错误的企微登录"
}

该企微号已经创建过机器人：

响应示例：

{
    "code": "1151",
    "msg": "该微信号已经创建企微机器人，请联系管理员分配"
}

客户端版本过低：

响应示例：

{
    "code": "1152",
    "msg": "当前客户端版本较低，请升级到最新版本后再试"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200在用户未扫码时

application/json

{
    "msg": "请扫码登录",
    "nodeServerCode": "node_server_0002",
    "code": "0",
    "siteCode": "wenode_chat_3081",
    "bizType": 5,
    "messageId": "20250326182837134137453984",
    "type": "robot.qrcode",
    "routing": "recv",
    "robotKey": "dd3296bdd2f84c6b93b568f0143c7760",
    "qrCode": "/base64********",
    "statUpSend": 1742984921218,
    "robotType": 2,
    "robotBizType": 5
}

Bodyapplication/json

示例

{}

🟢200登录成功后

🟢200未登录

🟢200使用错误的企微登录

🟢200该企微号已经创建过机器人

🟢200客户端版本过低

请求示例：#

请求参数说明：#

响应示例：#

用户未扫码时：#

登录成功后：#

未登录（未获取二维码直接调用登录检查时）：#

使用错误的企微扫码登录：#

使用错误的企微扫码登录：#

该企微号已经创建过机器人：#

客户端版本过低：#

请求参数

请求示例代码

返回响应

请求示例：

请求参数说明：

响应示例：

用户未扫码时：

登录成功后：

未登录（未获取二维码直接调用登录检查时）：

使用错误的企微扫码登录：

使用错误的企微扫码登录：

该企微号已经创建过机器人：

客户端版本过低：