数据标准OpenAPI

此手册用于记录大数据开发与管理平台中，数据标准产品所有对外开放的OpenAPI，阅读此手册，你将了解数据标准产品开放的OpenAPI能力与调用方法。

一、公共参数

1.1 响应格式

1.2 异常响应码

1.3 枚举列表表示词

1.3.1 ReferTypeEnum

关联类型

1.3.2 DictTypeEnum

1.4 基础实体

1.4.1 PageResult

分页查询结果

1.4.2 User

用户信息

1.5 词根

1.5.1 WordRoot

词根信息

1.5.2 WordRootTranslateResult

词根翻译结果

1.6 资源目录

1.6.1 DataDirectoryInfo

1.6.2 DataDirectory

资源目录树

1.7 字典

1.7.1 UserSimpleInfo

1.7.2 DictValue

1.7.3 Map

1.7.4 OpenDictDetailVO

字典详情信息

二、OpenAPI列表

2.1 OpenAPI总览

2.2 词根API

2.2.1 查询词根列表

GET /word-root/v1/list

产品版本：v1.4.0

描述：查询数据标准中词根列表

URL参数/请求体

请求示例：

curl -X GET http://easy-openapi.example.com/openapi/easystandard/word-root/v1/list?groupId=1&user=user@aa.com&pageSize=25&pageNum=1

请求示例：

?groupId=1&user=user@aa.com&pageSize=25&pageNum=1

响应体

响应示例：

{

  "code": 0,

  "reqId": "54798",

  "cost": 133,

  "msg": "success",

  "result": {

    "PageSize": 25,

    "pageNum": 1,

    "totalCount": 1,

    "totalPage": 1,

    "list": \[

      {

        "identifier": "ETM00002",

        "name": "游戏",

        "nameFullEn": "game",

        "nameEn": "game",

        "source": "体育竞技",

        "description": "专业术语"

      }

    \]

  }

}

2.2.2 中文翻译

GET /word-root/v1/translate

产品版本：v1.4.0

描述：根据词根进行中文翻译

URL参数/请求体

请求示例：

curl -X GET http://easy-openapi.example.com/openapi/easystandard/word-root/v1/translate/list?groupId=1&user=user@aa.com&text=原文

响应体

响应示例：

{

  "code": 0,

  "reqId": "79797",

  "cost": 828,

  "msg": "success",

  "result": {

    "nameEns": \[

      "gm"

    \],

    "nameFullEns": \[

      "game"

    \]

  }

}

2.3 资源目录API

2.3.1 查询资源目录树

GET /data-directory/v1/tree/list

产品版本：v1.3.1

描述：查询数据标准中的资源目录树

URL参数/请求体

请求示例：

curl -X GET http://easy-openapi.example.com/openapi/easystandard/data-directory/v1/tree/list?groupId=1&user=user@aa.com

响应体

响应示例：

{

  "code": 0,

  "reqId": "79622",

  "cost": 199,

  "msg": "success",

  "result": \[

    {

      "info": {

        "identifier": "OBJ",

        "name": "对象类别",

        "description": "对象分属类别",

        "required": false,

        "referInfo": {

            "easy\_map":0,

            "easy\_tag":0,

            "easy\_index":0

        }

      },

      "children": \[

        {

          "info": {

            "identifier": "WPXX",

            "name": "物品信息",

            "description": "物品所有信息",

            "required": false,

            "referInfo": {

                "easy\_map":0,

                "easy\_tag":0,

                "easy\_index":0

            }

          }

        }

      \]

    }

  \]

}

2.4 字典API

2.4.1 批量分类

POST dict/v1/category/batch/update

产品版本：v2.1.2

描述：批量更新字典分类

URL参数/请求体

请求示例：

{

  "identifiers": \["CD-B00000942", "CD-B00000945", "CD-B00000944"\],

  "dirPath": "/原始字典/原始分类/二级分类",

  "groupId": 65,

  "user": "yanxian01@corp.netease.com",

  "type": "ORIGINAL"

}

响应体

响应示例：

{

"code": 0,

"result": true,

"reqId": "f9b8a1cf1bc746da9d643ae729485b38",

"cost": 250

}

2.4.2 字典详情查询

GET dict/v1/get

产品版本：v2.1.2

描述：查询字典详细信息

URL参数/请求体

请求示例：

curl -X GET http://easy-openapi.example.com/openapi/easystandard/dict/v1/get?identifier=CD-B00000942&groupId=65&user=yanxian01@corp.netease.com&type=STANDARD

{

"identifier":"CD-B00000942",

"groupId":65,

"user":"yanxian01@corp.netease.com",

"type":"STANDARD"

}

响应体

响应示例：

{

"code": 0,

\-"result": {

"id": 1655,

"name": "id\_cn",

"nameEn": "CDB00000946",

"nameFullEn": "CDB00000946",

"identifier": "CD-B00000946",

"classification": "id\_cn",

"type": "ORIGINAL",

"description": "元数据导入自动创建",

"version": "1.0.0",

"status": "ADDITION",

\-"creator": {

"email": "yangmin06@corp.netease.com",

"fullName": "杨敏"},

"dirId": 65,

\-"dictValues": \[

\-{

"code": "1",

"description": "2"},

\-{

"code": "3",

"description": "4"}\],

"dirTreePath": "原始字典/默认分类",

"createTime": "2023-08-10 14:13:29"},

"reqId": "6e5878ad99ea4f7190bdc1889237b901",

"cost": 335}

2.4.3 创建字典目录

POST dict/v1/dir/add

产品版本：v2.1.4

描述：创建字典目录

URL参数/请求体

请求示例：

{

  "groupId": 65,

  "parentDirPath": "/原始分类",

  "name": "新目录",

  "type": "ORIGINAL",

  "user":"user"

}

响应体

响应示例：

{

"code": 0,

"msg":null,

"result": true,

"reqId": "f9b8a1cf1bc746da9d643ae729485b38",

"cost": 252

}