当前位置: 首页 > news >正文

Spring Boot 集成金蝶 API 演示

✨ Spring Boot 集成金蝶 API 演示:登录 / 注销 + Cookie 保存

本文将通过 Spring Boot 完整实现一套金蝶接口集成模型,包括:

  • ✅ 普通登录
  • ✅ AppSecret 登录
  • ✅ 注销
  • ✅ Cookie 保存与复用

📅 项目结构

src/
├── controller/
│   └── KingdeeController.java         // API 接口
├── service/
│   ├── KingdeeService.java            // 登录/注销逻辑
├── component/
│   └── KingdeeSessionManager.java     // Cookie 管理
├── resources/
│   └── static/pages/kingdee.html      // 前端测试页

✨ 1. Cookie 保存组件 KingdeeSessionManager

package org.example.component;import org.springframework.stereotype.Component;import java.util.List;/*** ==================================================* This class KingdeeSessionManager is responsible for [功能描述].** @author Darker* @version 1.0* ==================================================*/@Component
public class KingdeeSessionManager {private String cookie;public void saveFromHeaders(List<String> cookies) {if (cookies != null && !cookies.isEmpty()) {// 可扩展支持多个 Cookie,但这里我们只取第一个this.cookie = cookies.get(0);}}public String getCookie() {return this.cookie;}public boolean hasCookie() {return cookie != null && !cookie.isEmpty();}public void clear() {this.cookie = null;}
}

✨ 2. 金蝶服务层 KingdeeService

package org.example.service;import org.example.component.KingdeeSessionManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.*;
import org.springframework.stereotype.Service;
import org.springframework.web.client.RestTemplate;import java.util.HashMap;
import java.util.Map;/*** ==================================================* This class KingdeeService is responsible for 金蝶 API 服务.** @author Darker* @version 2.0* ==================================================*/
@Service
public class KingdeeService {private static final String BASE_URL = "https://your.kingdee.server/K3Cloud";@Autowiredprivate KingdeeSessionManager sessionManager;private ResponseEntity<String> postWithOptionalCookie(String url, Map<String, Object> payload, boolean withCookie) {RestTemplate restTemplate = new RestTemplate();HttpHeaders headers = new HttpHeaders();headers.setContentType(MediaType.APPLICATION_JSON);if (withCookie && sessionManager.hasCookie()) {headers.add("Cookie", sessionManager.getCookie());}HttpEntity<Map<String, Object>> request = new HttpEntity<>(payload, headers);return restTemplate.postForEntity(url, request, String.class);}/*** 普通登录*/public String login() {String url = BASE_URL + "/Kingdee.BOS.WebApi.ServicesStub.AuthService.ValidateUser.common.kdsvc";Map<String, Object> payload = new HashMap<>();payload.put("parameters", new Object[]{"你的数据中心 ID", "你的用户名", "你的密码", 2052});ResponseEntity<String> response = postWithOptionalCookie(url, payload, false);// 记录 CookiesessionManager.saveFromHeaders(response.getHeaders().get(HttpHeaders.SET_COOKIE));return response.getBody();}/*** AppSecret 登录*/public String loginByAppSecret() {String url = BASE_URL + "/Kingdee.BOS.WebApi.ServicesStub.AuthService.LoginByAppSecret.common.kdsvc";Map<String, Object> payload = new HashMap<>();payload.put("parameters", new Object[]{"你的数据中心 ID",                             // 数据中心 ID"你的用户名",                                  // 用户名"你的 AppID",    							  // AppID"你的 AppSecret",           				  // AppSecret2052});ResponseEntity<String> response = postWithOptionalCookie(url, payload, false);sessionManager.saveFromHeaders(response.getHeaders().get(HttpHeaders.SET_COOKIE));return response.getBody();}/*** 注销:需要携带 Cookie*/public String logout() {String url = BASE_URL + "/Kingdee.BOS.WebApi.ServicesStub.AuthService.Logout.common.kdsvc";Map<String, Object> payload = new HashMap<>();payload.put("parameters", new Object[]{});ResponseEntity<String> response = postWithOptionalCookie(url, payload, true);// 如果注销成功(返回 true),则清除本地 cookieif ("true".equalsIgnoreCase(response.getBody().trim())) {sessionManager.clear();}return response.getBody();}
}

✨ 3. Controller 接口 KingdeeController

package org.example.controller;import org.example.service.KingdeeService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.client.RestTemplate;
import org.springframework.http.ResponseEntity;
import org.springframework.web.util.UriComponentsBuilder;/*** ==================================================* This class KingdeeController is responsible for [功能描述].** @author Darker* @version 1.0* ==================================================*/@RestController
@RequestMapping("/kingdee")
public class KingdeeController {@Autowiredprivate KingdeeService kingdeeService;@GetMapping("/login")public ResponseEntity<?> login() {try {String result = kingdeeService.login();return ResponseEntity.ok(result);} catch (Exception e) {return ResponseEntity.internalServerError().body("登录失败:" + e.getMessage());}}@GetMapping("/logout")public ResponseEntity<?> logout() {try {String result = kingdeeService.logout();return ResponseEntity.ok(result);} catch (Exception e) {return ResponseEntity.internalServerError().body("注销失败:" + e.getMessage());}}@GetMapping("/login-app-secret")public ResponseEntity<?> loginByAppSecret() {try {String result = kingdeeService.loginByAppSecret();return ResponseEntity.ok(result);} catch (Exception e) {return ResponseEntity.internalServerError().body("AppSecret 登录失败:" + e.getMessage());}}
}

✨ 4. 前端测试页 kingdee.html

<!DOCTYPE html>
<html lang="zh">
<head><meta charset="UTF-8"><title>金蝶 API 测试</title><script>async function callApi(endpoint) {const res = await fetch(`/kingdee/${endpoint}`);const text = await res.text();document.getElementById('result').innerText = `[${endpoint}]:\n` + text;}</script>
</head>
<body><h2>金蝶 API 测试</h2><button onclick="callApi('login')">普通登录</button><button onclick="callApi('login-app-secret')">AppSecret 登录</button><button onclick="callApi('logout')">注销</button><pre id="result"></pre>
</body>
</html>

⚠️ Cookie 保存说明

  • 登录成功后,金蝶服务器会通过 Set-Cookie 头返回一个会话ID
  • 后续操作(注销 / 探量 / 单据传递)必须附带 Cookie
  • 本文中通过 KingdeeSessionManager 自动管理 Cookie,无需手动处理

🔗 金蝶 API 官方开发文档

官方开放平台:

  • 【K3Cloud Web API】总览:https://open.kingdee.com
  • 登录接口说明:https://open.kingdee.com/doc/view?doc_id=1055
  • App ID / Secret 说明:https://open.kingdee.com/doc/view?doc_id=1297
  • 提交单据示例:https://open.kingdee.com/doc/view?doc_id=1061

🔧 扩展方向

  • ✉ 增加 callKingdeeService(String serviceName, Object[] parameters) 通用调用方法
  • ✔ 支持查询单据 / 提交审核 / 操作单据
  • 📄 将登录状态持久化到 Redis

相关文章:

  • 电力实习中需要注意哪些安全用电问题
  • 【正点原子STM32MP257连载】第四章 ATK-DLMP257B功能测试——LVDS屏幕测试
  • 无人机设备遥控器之多控一机技术篇
  • Python实例题:Python自动获取海量IP工具
  • 施工现场针对性安全操作规范与施工现场用电安全隐患
  • 4.15 代码随想录第四十四天打卡
  • Beyond Compare:多平台文件对比工具
  • 零售业如何数字化转型
  • 数据分析实战案例:使用 Pandas 和 Matplotlib 进行居民用水
  • 设计模式:状态模式 - 复杂状态切换的优雅之道
  • Golang|select
  • 3. Framer Motion 中 motion 组件
  • 【目标检测】【YOLO综述】YOLOv1到YOLOv10:最快速、最精准的实时目标检测系统
  • Flutter 播放利器:`media_kit` 的详细介绍与使用指南
  • 在GitHub action中使用添加项目中配置文件的值为环境变量
  • Apache Kafka UI :一款功能丰富且美观的 Kafka 开源管理平台!!
  • Golang|Kafka在秒杀场景中的应用
  • day29图像处理OpenCV
  • gitlab如何查看分支的创建时间
  • tomcat http 怎么改成 https
  • 专访|伊朗学者:美伊核谈不只是改革派立场,但伊朗不信任美国
  • 银川市长信箱被指乱回复:问诗词大会、答工程欠款,官方称工作失误
  • 梅花画与咏梅诗
  • 最高法改判一起植物新品种侵权案:判赔逾5300万元破纪录
  • 《深化养老服务改革发展的大湾区探索》新书将于今年6月出版
  • 龚曙光:散文家永远只有一个视角,就是“我与时代”