摘要由AI智能服务提供本文介绍了苍穹API服务的使用流程，以操作服务为例，包括新增API操作服务、注册第三方应用、以及调用API的详细步骤。调用API时，首先获取appToken和access_token，然后使用access_token调用具体服务，需拼接URL并附加请求头，最后根据需求编写并注册插件。
苍穹API服务目前主要支持操作服务，自定义服务和AI服务，这里以操作服务为例，来介绍怎样使用API。
第一步：新增API操作服务。
开发服务云->开放平台->API服务，然后找到指定的单据，点击新增，然后根据需要选择操作服务或者自定义,然后可以选择对应的业务对象以及相关操作等。
第二步：注册第三方应用
开发服务云->开放平台->第三方应用，然后新增一个第三方应用，记住系统编码和系统名称。
第三步：调用API
这里分为3个步骤：
1）：获取appToken：
[api访问地址前缀] /api/getAppToken.do [POST]
请求示例：
http://localhost:8080/ierp/api/getAppToken.do
请求参数：
{
"appId": "EAS",
"appSecuret": "123456",
"tenantid": "dev_bos",
"accountId": "13525468784441",
"language": "zh_CN"
}
请求结果：
{
"data": {
"app_token": "12324eroeutrekdfgfkdkkk",
"success": true,
"error_desc": "",
"expire_time": 1535675659434,
"error_code": "0"
},
"state": "success"
}
传入参数 | 字段类型 | 是否必输 | 字段说明 |
appId | string | 是 | 第三方appId |
appSecuret | string | 是 | 第三方app的密码 |
tenantid | string | 是 | 租户ID |
accountId | string | 否 | 数据中心ID，如果不输入，默认会选取租户下的缺省数据中心 |
language | String | 否 | 语言字串：zh_CN,zh_TW等。默认系统默认语言 |
2）：获取access_token：
[api访问地址前缀] /api/login.do [POST]
请求示例：
http://localhost:8080/ierp/api/login.do
请求参数：
{
"user": "13825207590",
"apptoken": "a3270799-b482-4697-931f-2fb68b56bdf2",
"tenantid": "devbiz ",
"accountId": "1534920374578620490",
"usertype": "Mobile"
}
请求结果：
{
"data": {
"access_token": "f035550a-f9e8-4cc6-a775-8a21462a9f8b",
"success": true,
"error_desc": "",
"expire_time": 1535680289307,
"error_code": "0"
},
"state": "success"
}
传入参数 | 字段类型 | 是否必输 | 字段说明 |
user | string | 是 | 用户手机号 |
apptoken | string | 是 | 上一个接口的应用令牌（app_token） |
tenantid | string | 是 | 租户ID |
accountId | string | 否 | 数据中心ID，如果不输入，默认会选取租户下的缺省数据中心 |
usertype | String | 否 | Mobile： 标识为手机，默认为手机 Email：标识为email UserName：标识为用户名 |
language | String | 否 | 语言字串：zh_CN,zh_TW等。默认系统默认语言 |
3）：调用相关服务：
首先拼接url：[api访问地址前缀]+/kapi/+api服务对应的url
然后根据对应的请求方式去请求，请求头中Headers需要加accessToken，例如保存操作，则需要传相应的数据进去，包括单据编号，单据名称等。最好还可以根据需要编写插件并注册。
关于api操作具体也可以到门户网站去看相关视频。
赞 29
打赏