**变更记录**
|产品版本|更新内容|更新日期|
|-|-|-|
|V4.0.006 |初始版本|2021年8月|
|V6.0.1 |应用更名为OpenAPI，迁移至开放服务云；第三方应用支持增强型Token认证|2023年10月|
---
## 1 适用范围
本文档为外部系统调用金蝶云苍穹OpenAPI接口指南和流程。
## 2 调用流程
外部系统访问金蝶云苍穹OpenAPI，首先需要通过第三方应用和苍穹用户（user）获取access_token，然后在请求头中携带access_token访问接口服务了。
备注：access_token中包含接口用户信息，操作API会根据用户权限对业务进行管控，自定义API需在插件中自行处理权限控制。
### 2.1 注册第三方应用
路径：【开放服务云】→【OpenAPI】→【第三方应用】，点击“新增”按钮后，打开第三方应用新增界面，填写系统编码，AccessToken加密认证密钥等信息，点击保存按钮。
### 2.2 获取access_token
调用方根据第三方应用信息获取access_token，access_token默认有效期是两小时，详见[获取access_token](https://vip.kingdee.com/knowledge/specialDetail/226337046514476288?category=239331354741842688&id=489812471545485056&productLineId=29)
（若苍穹版本低于V6.0.1，[获取access_token参考](https://vip.kingdee.com/article/491614364106171648?productLineId=29&isKnowledge=2)）
备注：接口调用状态根据参数status进行判断，若成功则为"true"，失败则为"false"。
当接口调用失败时，还会返回错误码ErrorCode。
### 2.3 调用服务
#### 2.3.1 操作服务
金蝶云苍穹可直接将单据或基础资料的常用操作如查询、保存、删除、审核等快速发布为操作API，然后供第三方应用调用。请求头参数需要携带access_token（访问令牌）和content-type（内容格式）信息，按照规范的请求方式调用接口。
详见[操作API介绍](https://vip.kingdee.com/knowledge/specialDetail/226337046514476288?category=322414926260669696&id=263964194037744640&productLineId=29)
#### 2.3.2 自定义服务
自定义服务不依附任何业务对象，请求参数和响应参数可以完全自定义，主要处理逻辑通过Java插件、脚本或Servlet开发的方式实现，自定义服务主要用于处理特殊的集成场景。
详见[自定义API（Java插件）](https://vip.kingdee.com/k
