玩转搭贝
表单管理
表单设计
流程设计
流程设计
流程常见问题
仪表盘
基础图表
自定义组件
常见问题FAQ
列表相关FAQ
业务规则FAQ
数据导入FAQ
更新日志
场景解决方案
人事/绩效
行政/资产
销售/客户
项目/任务/工单
物业/园区
进销存/仓储
商管/租赁
法律业务
行业解决方案
制造业/工业生产
- 搭贝学院
- 开放接口
- 认证接口
认证接口
发布人：爱搭贝
更新时间：2026-05-19
搭贝认证用户信息
场景
用户服务可通过本接口
接口地址
/oauth2/users/user_info
请求方式
GET
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| client_id | string | 是 | 客户端身份标识，由搭贝提供 |
| client_secret | string | 是 | 客户端密钥，由搭贝提供 |
| grant_type | string | 是 | 固定值 authorization_code |
| code | string | 是 | oauth的code,根据code获取token |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| id | string | 用户id |
| departmentId | string | 主部门 |
| departmentIds | array->string | 兼职部门 |
| name | string | 用户姓名 |
| username | string | 用户姓名 |
| phone | string | 手机号，注意：只有用户配置此值有效，主要用于私有化部署 |
样例：
{
"errcode": 0,
"errmsg": "success",
"data": {
"departmentId": "3f9366618cb843c287b3290ec3b8e2a1",
"departmentIds": [
"3f9366618cb843c287b3290ec3b8e2a1"
],
"id": "46e9258b7205453697e381c9b4b5477c",
"phone": "18912341234",
"username": "user001",
"name": "李易峰"
},
"success": true
}自有认证中心接口
此模式下，以用户自有认证中心为主，搭贝提供接口以实现sso对接。 注意：使用此模式，phone和username必有值
获取搭贝authority_code
场景
三方自有认证中心通过本接口向搭贝发起请求获取搭贝为某个用户分配的授权code，获取该code后可以带着code redirect至搭贝原页面，搭贝前后端将根据本code自动实现认证，也可以通过该code通过服务端获取用户信息
接口地址
/oauth2/authority_code
请求方式
GET
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| client_id | string | 是 | 客户端身份标识，由搭贝提供 |
| client_secret | string | 是 | 客户端密钥，由搭贝提供 |
| username | string | 选择性必填 | 与phone二选一，优先本选项 |
| phone | string | 选择性必填 | 与username二选一，优先按username获取 |
响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 授权code，此code与搭贝oauth2 code完全相同，可以： |
| 1.在浏览器跳转至搭贝应用的url拼接code=$authority_code以实现页前端用户免登录。 | ||
| 2.服务端可以根据本code获取搭贝的用户信息以实现自定义业务扩展 |
样例：
{
"errcode": 0,
"errmsg": "success",
"data": {
"code":"cc58f62261ed4a5099bcea41d6fdcbaa"
},
"success": true
}
本篇目录
{{ dl1.name }}
{{ dl2.name }}
{{ dl3.name }}