山东产业大脑能力中心

第三方免密登录集成指南

V1.0

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

20254


 

一、 集成概述

省产业大脑能力中心支持接入各类第三方优质业务平台,面向产业集群与辖区企业提供一体化赋能服务。

本方案采用OAuth2.0 授权码模式单点登录,用户仅需完成一次身份校验登录,即可免密跳转访问完成关联配置的多套可信业务系统,无需重复输入账号密码,提升跨平台操作体验。

二、 整体集成流程

步骤1:由我方发起请求,调用贵方提供的 URL 地址,并将我方实时随机生成的code作为参数传递至贵方。

步骤2:贵方获取code、以及我方预先提供的clientIdclientSecret后,调用我方 Token 接口,获取并返回accessToken授权令牌。

步骤3:贵方凭借accessToken,可调用我方提供的用户信息接口、企业信息接口。

步骤4:贵方在内部完成用户信息处理与权限校验后,根据校验结果跳转至贵方平台首页或指定页面。

三、 集成接口规范

1、通用返回规范

所有接口响应数据统一为标准 JSON 字符串,禁止携带换行、制表符等特殊字符,避免解析异常。结构如下:

{"code":返回代码,"message":"描述","data":json}

参数

是否必须

描述

code

必须

返回代码 http状态码

message

非必须

描述,如:调用失败原因,成功提示等

data

非必须

返回JSON串,如:[{"X1":100,"XX1”:200},{"X2":100,"XX2”:200}]或{"X3":100,"XX3”:200}

测试环境URL地址:略

生产环境URL地址:https://www.industrysd.cn/server

2、产业大脑省平台用户认证地址

https://www.industrysd.cn/PortalManager/#/login?redirect_uri=loginURI&response_type=code&state=STATE&client_id=clientIdstring

3获取Token接口

l  接口地址:cydn-manager/noauth/ymconnect/accessToken

l  请求方式:GET

l  请求参数:

参数

类型

是否必须

参数说明

clientId

String

必须

客户端ID

clientSecret

String

必须

客户端密钥

code

String

必须

授权码

l  返回结果:

参数

类型

参数说明

accessToken

String

授权令牌

tokenType

String

令牌类型 当前为bearer

expiresIn

Integer

刷新时间

scope

String

默认返回“app

l  返回结果事例:

文本框: {
    "code": 200,
    "message": "操作成功!",
    "data": {
        "expiresIn": 1800,
        "scope": "app",
        "accessToken": "XXXXXXXXXXXXXXXXXXX",
        "tokenType": "bearer"
    }
}

4、获取用户信息接口

l  接口地址:cydn-manager/ymconnect/userInfo

l  请求方式:GET

l  请求参数:

参数

类型

是否必须

参数说明

authorization

String

必须

httpHeader请求头参数

(传参accessToken)

l  返回结果:

参数

类型

参数说明

userId

String

用户Id

type

Integer

0:管理员 1:普通用户,默认0

companyId

String

企业id

loginName

String

登录名

l  返回结果事例:

文本框: {
    "code": 200,
    "message": "操作成功!",
    "data": {
        "companyId": " XXXXXXXXXXXXXXXXXXXXXXXX ",
        "loginName": "XXXXXXXXXXX",
        "type": 0,
        "userId": "XXXXXXXXXXXX"
    }
}

5、获取企业信息接口

l  接口地址:cydn-manager/ymconnect/orgInfo

l  请求方式:GET

l  请求参数:

参数

类型

是否必须

参数说明

authorization

String

必须

httpHeader请求头参数

(传参accessToken)

l  返回结果:

参数

类型

参数说明

userId

String

用户Id

loginName

String

登录名(手机号)

companyId

String

企业Id

companyName

String

企业名称

legalPerson

String

法人

creditCode

String

统一社会信用代码

industry

String

行业

companyDesc

String

公司简介

companyScope

String

经营范围

linkMan

String

联系人

linkPhone

String

联系电话

position

String

职务

address

String

公司地址

l  返回结果事例:

文本框: {
    "code": 200,
    "message": "操作成功!",
    "data": {
        "userId": " XXXXXXXXXXXXXX",
        "loginName": "XXXXXXXXXXX",
        "companyId": " XXXXXXXXXXXXXX ",
        "companyName": "XXXXXXXXXXXXXX",
        "legalPerson": "XXXXXXXXXXXXXX",
        "creditCode": "XXXXXXXXXXXXXX",
        "industry": "XXXXXXXXXXXXXX",
        "companyDesc": "XXXXXXXXXXXXXX",
        "companyScope": "XXXXXXXXXXXXXX",
        "linkMan": "XXXXXXXXXXXXXX",
        "linkPhone": "XXXXXXXXXXXXXX",
        "position": "XXXXXXXXXXXXXX",
        "address": "XXXXXXXXXXXXXX"
    }
}