苍穹API服务原创
金蝶云社区-熊嘉强
熊嘉强
28人赞赏了该文章 8741次浏览 未经作者许可,禁止转载编辑于2020年12月18日 10:43:26

苍穹API服务目前主要支持操作服务,自定义服务和AI服务,这里以操作服务为例,来介绍怎样使用API。

第一步:新增API操作服务。

    开发服务云->开放平台->API服务,然后找到指定的单据,点击新增,然后根据需要选择操作服务或者自定义,然后可以选择对应的业务对象以及相关操作等。

image.png

第二步:注册第三方应用

     开发服务云->开放平台->第三方应用,然后新增一个第三方应用,记住系统编码和系统名称。

第三步:调用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

image.png

      然后根据对应的请求方式去请求,请求头中Headers需要加accessToken,例如保存操作,则需要传相应的数据进去,包括单据编号,单据名称等。最好还可以根据需要编写插件并注册。

      关于api操作具体也可以到门户网站去看相关视频。

赞 28