Open API获取鉴权

更新于 2026-01-26

网站版通过 Open API 获取鉴权 code，用于 Web 跳转时的登录验证。本文档介绍开放平台账号信息及接口请求参数详情。

开放平台账号

接入方提供

内容 说明
品牌名称 用于创建企业
Logo 用于创建企业
白单名IP 用于校验服务器请求IP

匠邦AI提供

内容 说明
appKey 匠邦AI提供的key
secret 匠邦AI提供的secret

请求API

获取鉴权code

说明

接口描述 获取鉴权code需调用此接口
⚠️

注意：每次进入加载 ifream 的时候，都需要重新获取 code 进行登录，一个 code 只能使用一次
请求域名 https://ai-user-api.jbangai.com
接口地址 /api/open/v1/third-auth
请求方式 POST
权限校验 是

请求参数

参数 类型 是否必传 参数说明
appKey string 是 appKey 由匠邦AI提供
secret string 是 Secret 由匠邦AI提供
sourceId string 是 接入方系统的用户id，指员工或用户的id
type string 是 用户类型（类型：user-用户，sys_user-员工，根据具体业务使用）
nickname string 否 用户昵称
avatar string 否 用户头像
phone string 否 用户手机号
openObjects array 否

参数为数组对象，接收如微信、QQ、apple、抖音等第三方登录信息，数组格式如下：

[
  {
    "appId": "微信公众号 appId",
    "id": "微信公众号对应用户的 openId",
    "type": "wx_mp"
  },
  {
    "appId": "微信公众号 appId",
    "id": "微信公众号对应用户的 unionId",
    "type": "wx_union"
  }
]

请求头

参数 类型 是否必传 参数说明
referer-host string 是 请求域名（在匠邦侧部署的网站域名）

请求示例

curl -X POST "https://ai-user-api.jbangai.com/api/open/v1/third-auth" \
  -H "Request-Origion:SwaggerBootstrapUi" \
  -H "accept:*/*" \
  -H "build:" \
  -H "referer-host:请求域名（在匠邦侧部署的网站域名）" \
  -H "timezone:" \
  -H "timestamp:" \
  -H "source:" \
  -H "guest-id:" \
  -H "version:" \
  -H "sign:" \
  -H "Content-Type:application/json" \
  -d '{"appKey":"VolejnKymknyejNm","avatar":"https:touxian1g","nickname":"接口测试用户 11244","openObjects":[{"appId":"wx66666","id":"11666666DXNIlg1ftSpuqA","type":"wx_mp"},{"appId":"wx777","id":"11ksa1kdkas","type":"wx_union"}],"phone":"13922212803","secret":"db6fe668e0f1dc91ac6c0b30edc9457c","sourceId":"13lo2","type":"user"}'

返回参数

参数 类型 说明
code string 响应编码
data string 授权code
message string 返回提示信息
serverTime string 当前时间戳

响应示例

{
  "code": 0,
  "data": "fb575a6140e45ff33c7690bcfbf55",
  "message": "",
  "serverTime": 1723516701
}