集成对象API

作者：吕传勇

1         概述

为提高集成平台的扩展性，集成云将部分接口封装为API供外部系统调用。集成对象API包括数据表、实体、视图、服务、查询类型的集成对象调用。

2         API文档

在集成服务云集成管理找到菜单【API管理】-【集成对象转API】页面进行新增API并生成文档。

新增API实例:

生成文档实例：

3         API接口

基于苍穹平台的API接口（参考《金蝶云苍穹登录接口API开发指南》），开发自定义服务，API调用时序图如下：

一般地，集成对象转API通用调用路径为：

http://{ip}:{port}/ierp/kapi/app/iscb/meta_{apiNumber}

注意：由于集成对象的执行需要用到集成对象转API数据，故在调用时确保对应的集成对象转API数据存在。

3.1          API

请求方式及url：

·     请求方式：POST

·     Content-type: application/json

·         接口地址： /ierp/kapi/app/iscb/meta_{apiNumber}

输入参数

请求示例:

http://localhost:8080/ierp/kapi/app/iscb/meta_{apiNumber}

header参数

access_token: 登录时获取的access_token

body参数

{

    "number": "test_demo",

    "name": "测试demo",

    "creator": 858405378470634496,

    "createtime": 1586855590029,

    "modifier": 858405378470634496,

    "modifytime": 1586855590029,

    "demo2": null,

    "entryentity": [

        {

            "seq": 1,

            "user": "",

            "password": "",

            "sex": false,

            "age": 0,

            "height": null,

            "birthday": 1586855590103,

            "email": ""

        }

    ]

}

响应json：

{

    "success": true,

    "data": {

        "id": "868807939191027712",

        "type": "INSERT"

    },

    "errorCode": "success"

}

4         注意

{

    "message": "自定义服务--appid：iscb  serviceName: meta_demo4_save 插件配置信息错误",

    "success": false

}

调用API时返回如上信息，请检查API是否启用，启用后即可解决该问题。

集成服务云使用指南：https://club.kdcloud.com/article/45312

集成服务云新特性发布汇总：https://club.kdcloud.com/article/146134