更新时间:2025-04-21 GMT+08:00
分享

执行iDME原子接口

操作场景

根据实际业务需求,按顺序调用一个或多个iDME原子接口,并为每个操作绑定唯一的事务ID,以确保所有相关操作都在一个完整的事务中执行。本章节将通过创建“ExtDataModel”数据实体的具体数据实例来演示如何使用这些原子接口,帮助用户掌握其操作流程和方法。

前提条件

开启事务

URI

  • URI格式:

    POST http://{Endpoint}/rdm_{appID}_app/services/dynamic/api/{entityName}/{atomicAPI}

  • 参数说明:
    表1 URI参数说明

    参数

    是否必填

    参数类型

    描述

    Endpoint

    String

    承载REST服务端点的服务器域名或IP地址。

    appID

    String

    应用ID。

    entityName

    String

    实体的英文名称。

    atomicAPI

    String

    实体的原子接口,例如create。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户的token。

X-Dme-Transaction-Version

String

v3版本的事务请求,只能设置为3

X-Dme-Transaction-Id

String

事务ID,即开启事务返回的transaction_id。

表3 请求Body参数

参数

是否必选

参数类型

描述

id

String

唯一编码。

rdmVersion

Int

系统版本。

rdmExtensionType

String

实体类型。

createTime

Date

创建时间。

creator

String

创建者。

lastUpdateTime

Date

最后更新时间。

modifier

String

更新者。

tenant

Object

租户。

根据实体类型、功能的不同,请求Body参数不同,您可以在全量数据服务查看实体对应API的具体参数。

响应参数

表4 响应Body参数

参数

参数类型

描述

result

String

调用是否成功。

  • SUCCESS:成功
  • FAIL:失败

data

List

调用的返回结果,默认为空。

errors

List

异常信息列表。

请求示例

POST https://dme.cn-north-4.huaweicloud.com/rdm_fce01234567d41828cf3473b07fa7ae2_app/services/dynamic/api/ExtDataModel/create
X-Auth-Token: ABCDEFG....
X-Dme-Transaction-Version: 3
X-Dme-Transaction-Id: 538322343718555649

响应示例

{
    "result": "SUCCESS",
    "data": [],
    "errors": []
}

相关文档