express_login_v2
快速登录
- URL：
/express_login_v2 - Method：
POST - 需要登录：是
- 需要鉴权：是
- updatetime: 2025-12-12
请求参数 （融合remote-addr参数）
| 参数 | demo | 必填 | 描述 |
|---|---|---|---|
| fastcode_local | k123456789 | 是 | 本地快码 |
| action | desktop | 是 | 远控插件, 之前都有传，只是desktop省略了，desktop也传上吧 |
| fastcode | 888888888 | 否 | 被控快码 |
| features | type_2 | 是 | 固定此值 |
| isseat | 0 | 否 | 是否是坐席 |
| check_statuscode | 1 | 否 | int型 检查被控statuscode, 位运算，后端根据&1 = 1, 来判断被控的statuscode是否需要立刻返回给主控 |
| reconnect_exp_v2 | 1 | 否 | bool 型主控第二次调用请传1， 传1后，将直达被控 |
信息
💡 注意，express_login 已有参数需要原样传输，上面是增补字段
以下已有字段可以留空传输（因为值都是remote-addr返回的）
p2paddr
common_speed
file_speed
origin_server_ip
请求示例
可以仅传递部分请求参数。
直连成功响应
条件：主机在线，并且被控支持直连
状态码：200 OK
响应示例：被控信息+access信息
字段含义：HttpsAddress // 原来被控返回的信息
access // 原来remote-addr 返回的内容
{
"HttpsAddress": "PHSRC_HTTPS://1976260044.slp2p-33617-std.oray.net:443/",
"PgyAddress": "PHSRC_PGY://89718675.slp2p-33617-std.oray.net:4118/",
"StunAddress": "120.26.127.206:5533",
"UdpAddress": "PHSRC://1976260044.slp2p-33617-std.oray.net:4118/",
"UdxAddress": "",
"clientid": "412c90dd-23ce-45f2-9922-08868d847e52",
"code": 0,
"extradata": "UsingMultiChannel://MP;UR://;",
"height": 918,
"isClip": 1,
"isDragdrop": 1,
"isKeyMouse": 1,
"is_support_control": "1",
"isbinding": "1",
"isinstalled": "1",
"islogin": "true",
"isprojection": "0",
"lastlogintime": "1751613887",
"license": "SHA1:qrjatydi;7mOnUK5tVxsHtLvO2/R9SOxftVQ=",
"localip": "192.168.204.128",
"mac": "00:0C:29:B4:F7:43",
"message": "Logon ok :-)",
"oray_code": 0,
"osinfo": "%7B%22auxchannel%22%3A1%2C%22camera%22%3A1%2C%22cmd%22%3A1%2C%22desktop%22%3A1%2C%22express%22%3A1%2C%22fastcmd%22%3A1%2C%22file%22%3A1%2C%22mac%22%3A%2200%3A0C%3A29%3AB4%3AF7%3A43%22%2C%22macsystemauth%22%3A1%2C%22ortc%22%3A1%2C%22os%5Fversion%22%3A%2210%2E0%2E19045%22%2C%22platform%22%3A%22window%22%2C%22rc%5Flan%5Fip%22%3A%22192%2E168%2E204%2E128%22%2C%22reconnect%22%3A1%2C%22sound%22%3A1%7D%0A",
"pcname": "DESKTOP%2DJOFJEQP",
"publicip": "180.173.166.152",
"refresh_p2p_session": "Ip5QOTGoHf7UQC1Axco9U8cGkKOvsPvD",
"session": "5cD3aeX3esRBLXQNVhSX1OXNE5rmqNir",
"starnetnodename": "",
"success": true,
"sys": "Windows%2010%20Enterprise",
"target": "window",
"useAeskey": true,
"version": "16.0.0.22931",
"width": 1598,
"access": {
"remote": {
"fastcode": "1477816926",
"state": 1,
"os_name": "{\"auxchannel\":1,\"camera\":1,\"cmd\":1,\"desktop\":1,\"ent_id\":\"0\",\"express\":1,\"fastcmd\":1,\"file\":1,\"mac\":\"00:0C:29:B4:F7:43\",\"macsystemauth\":1,\"ortc\":1,\"os_version\":\"10.0.19045\",\"platform\":\"window\",\"rc_lan_ip\":\"192.168.204.128\",\"reconnect\":1,\"sound\":1}",
"ip": "180.173.166.152",
"status_code": 19099,
"level": "free",
"new_server": 1,
},
"server": {
"host": "slp2p-33617-std.oray.net",
"addr": "PHSRC://slp2p-33617-std.oray.net:4118;PHSRC_HTTPS://slp2p-33617-std.oray.net:443;UsingMultiChannel://;",
"forward_addr": "PHSRC_HTTPS://slp2p-33617-std.oray.net:443",
"server_ip": "182.100.46.24",
"limits": {
"common": 10240,
"file": 10240
},
"addr_new": {
"phsrc_pgy": {
"addr": "PHSRC_PGY://slp2p-33617-std.oray.net:4118",
"ip": "182.100.46.24",
"authcode": "SHA1:xsF-FP33;FdZ+1IVlY6E2J18Uc7nzDc1QoKw="
},
"stun_server": {
"addr": "120.26.127.206:5533"
},
"phsrc": {
"addr": "PHSRC://slp2p-33617-std.oray.net:4118",
"ip": "182.100.46.24",
"authcode": "SHA1:HapBqvoi;ZXzREWzVb+2q0d9c01W5UBFLET4="
},
"phsrc_https": {
"addr": "PHSRC_HTTPS://slp2p-33617-std.oray.net:443",
"ip": "182.100.46.24",
"authcode": "SHA1:RIWQ4gAE;uJR287848RZO9db/pEQ2Y4w6Tt8="
},
"using_multi_channel": {
"addr": "UsingMultiChannel://"
}
},
"ip6_forward_first": true,
"ip6_p2p_first": true,
"auth": "l5lQJw/qkH2dhkwmwMmXhlhshNnqNAB3bgEPrDrv1jklr3T6LCR34jdb3hY+o7MQGh7ApIOqyrFUzqxK/gPi7g==",
"fps": {
"default": 30,
"game": 30,
"extreme": 30,
"intelligent": 30,
"pqopt": 30,
"tc444": 30
},
"encode_config": {
"game": {
"av1": true,
"h265": true,
"target_bitrate": 4000000,
"maximum_bitrate_coefficient": 0.25
}
}
},
"expires": 300,
"region": "east",
"level": "free",
"network": {
"p2p_server": {
"zh_cn": "华东",
"en": "East",
"zh_tw": "華東"
},
"control": {
"ip_addr": "183.233.96.66",
"isp": {
"zh_cn": "中国移动",
"en": "China Mobile",
"zh_tw": "中國移動"
}
},
"remote": {
"ip_addr": "180.173.166.152",
"isp": {
"zh_cn": "中国电信",
"en": "China Telecom",
"zh_tw": "中國電信"
}
}
}
"free_duration_limit": {
"limit_duration": "0", // 当前远控受限制时间 单位s
"used_duration": "458", // 累计远控时长
"remain_duration": "21142",
"remain_times": "0",
"used_times": "1", // 累计远控次数
"remind_nodes": "15,5" // 按顺序，逗号隔开，分别代表对应的剩余时间节点进行提醒
}
}
}
不可直连响应
条件：不可以直接连被控
状态码：200 OK
响应示例：返回被控泛域，slp2p等信息
字段含义：reconnect_exp // 重连标识，再拿access.remote.addr 重走express_login
access // 原来remote-addr 返回的内容
{
"reconnect_exp": 1,
"access": {
"remote": {
"fastcode": "1477816926",
"state": 1,
"addr": "https://api-std.sunlogin.oray.com/cgi-bin/login.cgi ",
"os_name": "{\"auxchannel\":1,\"camera\":1,\"cmd\":1,\"desktop\":1,\"ent_id\":\"0\",\"express\":1,\"fastcmd\":1,\"file\":1,\"mac\":\"00:0C:29:B4:F7:43\",\"macsystemauth\":1,\"ortc\":1,\"os_version\":\"10.0.19045\",\"platform\":\"window\",\"rc_lan_ip\":\"192.168.204.128\",\"reconnect\":1,\"sound\":1}",
"ip": "180.173.166.152",
"status_code": 19099,
"level": "free",
"new_server": 1,
"origin_server_ip": "47.96.131.205"
},
"server": {
"host": "slp2p-33617-std.oray.net",
"addr": "PHSRC://slp2p-33617-std.oray.net:4118;PHSRC_HTTPS://slp2p-33617-std.oray.net:443;UsingMultiChannel://;",
"forward_addr": "PHSRC_HTTPS://slp2p-33617-std.oray.net:443",
"server_ip": "182.100.46.24",
"limits": {
"common": 10240,
"file": 10240
},
"addr_new": {
"phsrc_pgy": {
"addr": "PHSRC_PGY://slp2p-33617-std.oray.net:4118",
"ip": "182.100.46.24",
"authcode": "SHA1:xsF-FP33;FdZ+1IVlY6E2J18Uc7nzDc1QoKw="
},
"stun_server": {
"addr": "120.26.127.206:5533"
},
"phsrc": {
"addr": "PHSRC://slp2p-33617-std.oray.net:4118",
"ip": "182.100.46.24",
"authcode": "SHA1:HapBqvoi;ZXzREWzVb+2q0d9c01W5UBFLET4="
},
"phsrc_https": {
"addr": "PHSRC_HTTPS://slp2p-33617-std.oray.net:443",
"ip": "182.100.46.24",
"authcode": "SHA1:RIWQ4gAE;uJR287848RZO9db/pEQ2Y4w6Tt8="
},
"using_multi_channel": {
"addr": "UsingMultiChannel://"
}
},
"ip6_forward_first": true,
"ip6_p2p_first": true,
"auth": "l5lQJw/qkH2dhkwmwMmXhlhshNnqNAB3bgEPrDrv1jklr3T6LCR34jdb3hY+o7MQGh7ApIOqyrFUzqxK/gPi7g==",
"fps": {
"default": 30,
"game": 30,
"extreme": 30,
"intelligent": 30,
"pqopt": 30,
"tc444": 30
},
"encode_config": {
"game": {
"av1": true,
"h265": true,
"target_bitrate": 4000000,
"maximum_bitrate_coefficient": 0.25
}
}
},
"expires": 300,
"region": "east",
"level": "free",
"network": {
"p2p_server": {
"zh_cn": "华东",
"en": "East",
"zh_tw": "華東"
},
"control": {
"ip_addr": "183.233.96.66",
"isp": {
"zh_cn": "中国移动",
"en": "China Mobile",
"zh_tw": "中國移動"
}
},
"remote": {
"ip_addr": "180.173.166.152",
"isp": {
"zh_cn": "中国电信",
"en": "China Telecom",
"zh_tw": "中國電信"
}
}
}
}
}
可直连，但是需要判断statuscode响应
条件：可直连，但是需要判断statuscode
状态码：200 OK
响应示例：返回被控status_code, 主控再来一次v2
字段含义：reconnect_exp_v2 // 重连标识v2, 重走express_login_v2, 并且参数携带reconnect_exp_v2=1
access // 仅返回fastcode里面的statuscode，其他slp2p信息不先返回（要让被控先拿到slp2p）
{
"reconnect_exp_v2": 1,
"access": {
"remote": {
"fastcode": "1477816926",
"state": 1,
"os_name": "{\"auxchannel\":1,\"camera\":1,\"cmd\":1,\"desktop\":1,\"ent_id\":\"0\",\"express\":1,\"fastcmd\":1,\"file\":1,\"mac\":\"00:0C:29:B4:F7:43\",\"macsystemauth\":1,\"ortc\":1,\"os_version\":\"10.0.19045\",\"platform\":\"window\",\"rc_lan_ip\":\"192.168.204.128\",\"reconnect\":1,\"sound\":1}",
"status_code": 19099
}
}
}
错误响应
条件：主机不在线|禁止跨境远控提示
状态码：oray_errcode
响应示例:
| code | 错误信息 | 流程 |
|---|---|---|
| 150626313 | 主机不在线 | 弹窗 |
| 150724616 | 禁止跨境远控错误提示 | 弹窗，再走/usersvc/svcdoc/:userid 拿错误信息 |
{
"error": "access/remote_host_offline",
"code": 150626313,
"message": "remote_host_offline"
}
注意事项
信息
💡 无
流程时序图
修改于 2026-03-25 09:45:04