## 1、准备 API 测试环境（K3Cloud 服务器）
- 非本帖重点，省略
## 2、了解 API 整体设计
- [`金蝶云星空WebAPI接口说明书_V6.0`](https://wenku.my7c.com/article/407944297573586944)
## 3、选择 API 开发套件（[`SDK`](https://www.npmjs.com/package/@kingdee-nodejs/k3cloud)）
- [`https://www.npmjs.com/package/@kingdee-nodejs/k3cloud`](https://www.npmjs.com/package/@kingdee-nodejs/k3cloud)
## 4、查阅 API 调用参数
- [`https://openapi.open.kingdee.com/ApiDoc`](https://openapi.open.kingdee.com/ApiDoc)
## 5、确认 API 调用结果（[`Demo`](https://github.com/kingdee-nodejs/k3cloud-demo)）
- 准备
```shell
$ git clone git@github.com:kingdee-nodejs/k3cloud-demo.git
$ cd k3cloud-demo
$ npm install
```
- 配置（写入 K3Cloud 服务器相关参数）
```shell
$ vi test.js
...
config = {
auth_type: 3, // 授权类型：1 用户名+密码；2 第三方授权应用ID+应用密钥；3 签名；
host_url: "http||https://xxxxxxxxxxxxxxxxx/k3cloud/", // 金蝶授权请求地址
acct_id: "xxxxxxxxxx", // 账户ID
username: "xxxxxxxxxx", // 用户名（授权类型为1时必须）
password: "xxxxxxxxxx", // 密码（授权类型为1时必须）
appid: "xxxxxxxxxx", // 应用ID（授权类型为2或3时必须）
appsecret: "xxxxxxxxxx", // 应用Secret（授权类型为2或3时必须）
lcid: 2052, // 账套语系，默认2052
};
...
```
- 运行
```shell
$ node test.js
```
- 确认
```json
{"Result":{"ResponseStatus":{"IsSuccess":true,"Errors":[],"SuccessEntitys":[],"SuccessMessages":[],"MsgCode":0},"NeedReturnData":{"Id":"BD_MATERIAL","Name":[{"Key":2052,"Value":"物料"}], ...
```
