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

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

进入API查找界面

进入数据地图页面。
登录DataWorks控制台，切换至目标地域后，单击左侧导航栏的数据治理 > 数据地图，在右侧页面中单击进入数据地图。
在搜索框上方，选择API类目，进入查找API的页面。
搜索栏左侧的搜索类型下拉菜单包含代码、API和数据集三个分组，在API分组中选择API。

查找API

在API类目下的搜索框中输入API ID、APIPath、API名称、API描述等关键字进行搜索。
在搜索框中输入关键字后，将通过关键字匹配，在搜索框的下拉列表中初步筛选，展示出符合条件的前10个API。
如果在搜索框的下拉列表中无法定位到目标API，可以单击搜索，在列表中展示出所有符合条件的API。
您可以在页面左侧根据API类型、工作空间、负责人对搜索结果中的API进行二次过滤。
找到目标API后，如需查看API详情，可以单击目标API进入详情页。详情请参见查看API详情。

查看API详情

API详情页面为您展示API的基础信息、技术信息、参数信息、返回示例和使用说明。若 API 为脚本模式，还会额外展示代码页签。

API 详情页面分为以下三个区域：区域①位于页面顶部，展示 API 名称、描述及编辑 API 入口；区域②位于左侧面板，展示 API 的基础信息和技术信息；区域③位于右侧面板，通过页签展示参数信息、返回示例、血缘信息和使用说明等详细内容。各区域的具体信息如下表所示。

区域	描述
①	单击编辑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。使用说明：您可以进行编辑、查看历史版本的操作，根据业务说明了解相关的信息。代码：仅当 API 为脚本模式时显示此页签，查看开发者编写的自定义查询代码（如 SQL）。其他 API 类型（如向导模式、注册 API、服务编排 API）不展示该页签；向导模式 API 的 SQL 需要在数据服务的 API 开发编辑器中查看。说明如果您从数据地图全局搜索框中直接搜索代码片段命中脚本模式 API，系统会自动定位到代码页签。