全部产品
Search

搜索本产品

    大数据开发治理平台 DataWorks：数据服务API

    文档中心

    大数据开发治理平台 DataWorks：数据服务API

    更新时间：Nov 13, 2024

    数据地图支持对当前租户下所有工作空间的数据服务API进行搜索和定位，实现数据服务API的高效查找。

    进入API查找界面

    1. 进入数据地图页面。

      登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的数据目录 > 数据地图，在右侧页面中单击进入数据地图。

    2. 在搜索框上方，选择API类目，进入查找API的页面。

      image.png

    查找API

    1. 在API类目下的搜索框中输入API ID、API Path、API名称、API描述等关键字进行搜索。

      在搜索框中输入关键字后，将通过关键字匹配，在搜索框的下拉列表中初步筛选，展示出符合条件的前10个API。image.png

    2. 如果在搜索框的下拉列表中无法定位到目标API，可以单击搜索，在列表中展示出所有符合条件的API。

      image.png

    3. 您可以在页面左侧根据API类型、工作空间、负责人对搜索结果中的API进行二次过滤。

    4. 找到目标API后，如需查看API详情，可以单击目标API进入详情页。详情请参见查看API详情。

    查看API详情

    API详情页面为您展示API的基础信息、技术信息、参数信息、返回示例和使用说明。image

    区域

    描述

    ①

    单击编辑API跳转至API所属工作空间的编辑窗口进行API编辑。详情请参见发布API和注册API。

    说明

    ：如果当前登录账号不在API所属的工作空间中，请联系目标工作空间对应管理员将您的账号添加到目标空间的成员列表中并赋予开发者角色，详情请参见空间级模块权限管控。

    ②

    在该区域您可以查看该API的如下信息：

    • 基础信息：您可以查看API的浏览次数、调用次数、API ID、工作空间、负责人、创建时间、更新时间、描述等信息。

    • 技术信息：您可以查看API类型、请求方式、返回类型、数据源类型、数据源名称、表名称等信息。

    ③

    在该区域您可以查看该API的如下信息：

    • 参数信息：您可以查看API的请求参数、返回参数。

      • 请求参数：您可以查看公共请求参数和应用请求参数的参数名、参数类型、参数位置、示例值、默认值、描述、标签等信息。

      • 返回参数：您可以查看公共返回参数和应用返回参数的参数名、参数类型、示例值、描述等信息。

    • 返回示例：在API发布前，如果对API进行测试并在测试时勾选了自动保存正常返回示例，将根据测试结果更新API返回示例。详情请参见测试API，您可以根据返回示例的数据内容和数据结构了解API返回结果。

    • 血缘信息：您可以查看数据表、API、APP之间的完整血缘关系。数据接口API的上游血缘支持的数据源类型包括：Hologres、MySQL、PostgreSQL、SQL Server、Oracle、AnalyticDB for MySQL 3.0、AnalyticDB for PostgreSQL。

      说明

      • 生成API是通过数据源或表封装的API，因此血缘链路将包括：数据表、API、APP。

      • 注册API是通过后端地址封装的API，因此血缘链路将仅包括：API和APP。

      • 血缘信息的产出、更新的时效是T+1。

    • 使用说明：您可以进行编辑、查看历史版本的操作，根据业务说明了解相关的信息。