接入指南

资金系统提供的授权登录方式，可以让企业应用系统通过后台调用接口获取成员登录使用的临时授权码，构建资金系统登录的 URL 链接，从而免去资金系统的登录环节

接入流程

企业员工通过浏览器登录企业应用

企业应用后台程序获取当前用户信息，并使用当前员工信息调用资金系统获取登录预授权码接口

资金系统校验企业应用信息及用户信息成功后返回登录预授权码给企业应用

企业应用根据资金系统返回的临时授权码构建登录认证链接

员工点击后，跳转至资金系统完成身份认证，并跳转到资金系统对应页面（goto 地址，若未配置默认调整到首页）

构建登录认证链接

企业应用需要构造如下的链接来实现资金系统无感登录

https://{资金系统域名}/iam/login/sso/code?code=CODE&goto=GOTO

接口说明

请求url：https://{资金系统开放平台域名}/openapi/auth/authorize
请求方式：POST

Header 参数

参数	必填	说明
code	是	签名认证信息
goto	否	签名认证信息

示例

假定登录预授权码为 1e98e7996147478f9a8c79de9792e10b 登录跳转地址为：https://cfs.yocyl.com/#/index 根据URL规范，将上述参数分别进行UrlEncode，得到拼接的登录认证链接为：https://{资金系统域名}/iam/login/sso/code?code=1e98e7996147478f9a8c79de9792e10b&goto=https%3A%2F%2Fcfs.yocyl.com%2F%23%2Findex

API 业务错误码

HTTP状态码	状态说明	错误码	错误描述	解决方案
200	请检查入参信息（必填，格式，匹配值，长度等）	400001		请检查入参信息
200	预授权码未过期,请勿重复获取.	500001	此用户的预授权码未过期	使用申请过的预授权码
200	用户身份信息校验失败.	500002	系统中为获取到用户信息	请在系统管理/用户维护/三方信息中维护用户信息
200	预授权码请求频繁,请稍后重试.	500003	并发请求获取预授权码	请检查的应用程序是否同时请求预授权码接口
200	预授权码非法,请检查预授权码格式.	500004	请求的资源不存在	检查资源路径
200	预授权码不存在或已过期,请重新获取.	500005		请重新获取预授权码
200	用户已锁定,请联系管理员解锁.	500006		请联系管理员解锁
200	用户已注销,请联系管理员.	500007		请联系管理员

身份认证

接入指南#

接入流程#

构建登录认证链接#

接口说明#

示例#

API 业务错误码#

接入指南

接入流程

构建登录认证链接

接口说明

示例

API 业务错误码