橙讯开放平台基线
首页服务端API客户端API附录橙讯官网
首页服务端API客户端API附录橙讯官网
  1. 单点登录
  • 开发前准备
  • 组织自建应用对接
    • 获取访问凭证
      • 获取访问凭证
    • 单点登录
      • 概述
      • 应用单点登录
        GET
      • 管理员单点登录
        GET
    • 消息推送
      • 概述
      • 消息推送
      • 消息撤回
    • 通讯录同步
      • 概述
      • 获取通讯录
        • 获取全量通讯录
        • 获取增量通讯录
      • 回调通知
        • 回调通知说明
    • 机器人
      • 概述
      • 创建群
      • 更新群
      • 查询群信息
      • 解散群
      • 设置群公告
      • 查询机器人创建的群列表
      • 发送群消息
      • 给指定用户发送消息
    • 待办
      • 概述
      • 创建待办
      • 更新待办
      • 删除待办
      • 更新待办执行人
    • 待阅
      • 概述
      • 创建待阅
      • 更新待阅
      • 删除待阅
      • 更新待阅执行人
    • 工作台卡片
      • 概述
      • 添加应用卡片模板
      • 获取应用的卡片模板列表
      • 更新应用卡片模板
      • 删除应用卡片模板
      • 设置卡片组织级数据
      • 批量设置卡片数据(卡片数据不同)
      • 批量设置卡片数据(卡片数据相同)
    • 错误码
      • 错误码
  • 组织服务对接
    • 组织服务对接准备
    • 对接流程
      • 概述
      • 换取企业永久授权码
      • 获取访问凭证
      • 获取全量通讯录
      • 获取增量通讯录变更
      • 更新通讯录
    • 错误码
      • 错误码
  • 历史版本(不推荐)
    • 组织自建应用对接
      • 通讯录同步
        • 概述
        • 获取通讯录
          • 获取全量通讯录
          • 获取增量通讯录
        • 回调通知
          • 回调通知说明
      • 消息推送
        • 概述
        • 消息推送
  1. 单点登录

应用单点登录

GET
/apps/v1/sso/user
接口描述:外部应用服务器端收到自己客户端发来的带有授权码(授权code)的登录请求后,调用该接口来获取授权用户的信息,完成单点登录。
请求地址:https://service.cheng-xun.cn/api/apps/v1/sso/user?access_token={access_token}&oauth_code={oauth_code}
请求方式:GET
请求Body:无#

请求参数

Authorization
Query 参数
access_token
string 
必需
接口“获取访问凭证access_token”返回的结果
<= 256 字符
oauth_code
string 
必需
授权码,前端或者客户端传递来的
<= 256 字符
Header 参数
User-Agent
string 
可选
默认值:
CX

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://service.cheng-xun.cn/api/apps/v1/sso/user?access_token&oauth_code' \
--header 'User-Agent: CX'

返回响应

🟢200成功
application/json
Body
err_code
integer 
可选
err_msg
string 
可选
默认值:
ErrorCode.SUCCESS.getErrMsg()
account_id
string 
帐号id
必需
<= 64 字符
name
string 
姓名
必需
<= 64 字符
sex
string 
性别
必需
<= 10 字符
email
string 
邮箱
必需
<= 100 字符
corp_id
number 
组织id
必需
corp_name
string 
组织名称
必需
<= 256 字符
mobile
string 
手机号
必需
<= 50 字符
nick_name
string 
别名
必需
<= 64 字符
portrait
string 
头像
必需
<= 2000 字符
portrait_small
string 
头像缩略图
必需
<= 2000 字符
staff_id
number 
用户在该组织内的通讯录id
必需
job_number
string 
工作号码
必需
<= 50 字符
示例
{
    "err_code": 0,
    "err_msg": "Success.",
    "account_id": "12345",
    "name": "张三",
    "sex": "男",
    "email": ",",
    "corp_id": 6784645111,
    "corp_name": "",
    "mobile": "",
    "nick_name": "张杨",
    "portrait": "",
    "portrait_small": "",
    "staff_id": 1234,
    "job_number": "123456"
}
修改于 2025-04-01 02:36:03
上一页
概述
下一页
管理员单点登录
Built with