SSO 免登录到企业后台子页面

此 API 用于获取 SSO 免登录到猎户星空企业后台（接待后台）子页面的 URL；

数据维度授权	企业级授权	此 API 为企业级授权，企业级授权和代理商级授权的授权账号均可以调用此 API。请参考授权方式。

接口维度授权	默认授权	此 API 为默认授权，您无需为您的授权账号额外申请接口维度授权就可以调用。请参考授权方式。

请在第三方系统（您的系统）的相同登录态会话内尽量复用有效期内的跳转 URL，而不是每次跳转到子页面都重新获取跳转 URL;
猎户星空可能会限制同一个授权账号每天获取子页面跳转 URL 的次数，以防止每次进入子页面都创建新的登录态会话导致过多的会话资源占用;

区域	域名
中国区	https://openapi.orionstar.com
欧洲区	https://global-openapi.orionstar.com
美国区	https://us-openapi.orionstar.com
日本区	https://jp-openapi.orionstar.com

HTTP URL 路径	/v1/sso/corp_admin_page_sso
HTTP Method	GET

参数	类型	必填	说明
Authorization	string	是	访问凭证 access_token 格式：`Bearer access_token` 示例：`Bearer T.WcnhSdYj-kwVBpP27LRQrw.OBt95zE4TH-OPzIX6OkEWPo4rbR6s.ori-67facfd90b2744220a5eae850e51` 请参考：鉴权方法

参数	类型	必填	参数说明
sso_acct_mobile	string	是	免登录的目标企业账号的手机号，SSO 免登录相当于不用输入账号密码，直接使用此手机号对应的账号登录猎户星空企业后台（接待后台）。
sso_acct_id	string	否	第三方系统（您的系统）的账号 id，如果传递了此参数猎户星空会原样记录。不能超过 64 字节。
sso_acct_name	string	否	第三方系统（您的系统）的账号昵称或者姓名。如果传递了此参数，免登录到猎户星空企业后台（接待后台）之后，当前账号的姓名会显示成此参数的值。不能超过 16 个字。
sso_acct_avatar_url	string	否	第三方系统（您的系统）的账号头像 URL。如果传递了此参数，免登录到猎户星空企业后台（接待后台）之后，当前账号的头像会显示成此参数的值。不能超过 256 字节。
target_route	string	是	企业后台子页面的路由地址，不同的子页面的路由地址是不同的，请在您确认子页面后联系猎户星空售前技术支持获取路由地址。
target_args	string	否	附加到跳转 URL 中的参数，格式为 json 对象字符串。不同的子页面可能会需要传入一些业务参数，请在您确认子页面后联系猎户星空售前技术支持获取需要附加的参数。例如 {"robot_sn": "SN"}

# 请根据您的区域替换域名
curl --location 'https://openapi.orionstar.com/v1/sso/corp_admin_page_sso?sso_acct_mobile=13512345678&target_route=test_route' \
     --header 'Authorization: Bearer YOUR-ACCESS-TOKEN'

参数	类型	参数说明
code	int	错误代码。0 是成功，非 0 是失败，请参考错误代码。
msg	string	错误描述，当失败的时候会给出具体的错误描述。
req_id	string	日志跟踪 id，当遇到问题需要猎户星空协助查问题时候，请提供此跟踪 id 值。
data	object	业务数据 data 对象，详见下述响应体 data 对象。

参数	类型	参数说明
redirect_url	string	SSO 免登录跳转 URL，有效期 60 秒。
expires_in	string	跳转 url 有效期，单位是秒。例如 14400 表示跳转 URL 的有效期是 4 个小时，请注意是字符串类型的整数。

{
    "code": 0,
    "msg": "",
    "data": {
        "redirect_url" : "https://jiedai.orionstar.com/capi/v1/corp/admin_sso_auth?sso_token=test_token&target_type=main",
        "expires_in" : "14400"
    }
}

SSO 免登录到企业后台子页面

概述

授权方式

注意事项

请求

请求域名

请求协议

公共请求头

请求 URL 参数

请求 cURL 示例

响应

公共响应体

响应体 data 对象

响应体示例