文档

注册API

更新时间:

您可以将已有的API服务注册到DataWorks数据服务中,以实现统一的发布和管理(例如查看API的调用信息、调用日志,管理API标签、版本等),本文为您介绍如何注册API。

注册API

如果您没有API,则需要使用生成API功能。详情请参见通过向导模式生成API

  1. 服务开发页面,鼠标悬停至新建图标,单击注册API

    您也可以打开相应的业务流程,右键单击API,选择新建 > 注册API

  2. 注册API对话框中,配置各项参数。

    注册API

    参数

    描述

    API名称

    支持中文、英文、数字、下划线(_),且只能以英文或中文开头,4~50个字符。

    API Path

    API存放的路径,例如/user

    说明

    支持英文、数字、下划线(_)和连字符(-),且只能以( /) 开头,不得超过200个字符。

    协议

    支持HTTPHTTPS协议。

    如果您需要通过HTTPS协议调用API,请您发布API至网关后,在API网关控制台绑定独立域名,并上传SSL证书。详情请参见支持HTTPS

    请求方式

    支持GETPOSTPUTDELETE

    返回类型

    支持JSONXML

    可见范围

    包括工作空间私有

    • 工作空间:该API对本工作空间内的所有成员可见。

    • 私有:该API仅对API的负责人可见,且暂不支持授权。

      说明

      如果设置可见范围为私有,在目录树中,仅自己可见,工作空间内的其他成员不可见。

    标签

    标签列表中选择相应的标签,详情请参见创建及管理API标签

    说明

    标签名称支持汉字、英文、数字和下划线(_),您最多可以设置5个标签,且每个标签不超过20个字符。

    描述

    对API进行简要描述,不得超过2000个字符。

    目标文件夹

    存放API的目录。

  3. 单击确认

配置API

  1. 双击打开注册API的编辑页面,在后端服务定义区域,配置各项参数。

    后端服务定义

    参数

    描述

    后台服务Host

    待注册API服务的Host,以http://https://开头,并且不包含Path。

    说明

    示例:假设您接口服务地址为http://xxx-cn-xxx.alicloudapi.com/user/info,可取http://xxx-cn-xxx.alicloudapi.com设为后台服务Host。具体的可根据您接口服务地址实际路径进行配置。

    后台服务Path

    待注册API服务的Path,Path中支持参数,参数要放在[]中,如/user/[userid]

    配置Path中的参数后,在注册API向导的第二步API参数配置环节,系统会自动在请求参数列表添加Path位置的参数。

    说明

    示例:假设您接口服务地址为http://xxx-cn-xxx.alicloudapi.com/user/info,可将/user/info设为后台服务Path。具体的可根据您接口服务地址实际路径进行配置。

    后端超时

    设置后端超时时间。

  2. 请求参数定义区域,配置各项参数。

    请求参数定义

    参数

    描述

    请求参数

    您可以单击新增参数,根据页面配置API的请求参数。

    其中参数位置支持QUERYHEADBODY。不同的请求方式支持不同的参数位置,请根据页面提供的可选项按需选择。

    常量参数

    参数值为固定的参数,对调用者不可见。调用API时无需传入常量参数,但后台服务始终接收您在此处配置的常量参数及参数值。

    适用于固定某个参数的取值并对调用者隐藏参数的场景。

    请求Body定义

    仅请求方式为POSTPUT时,会出现该参数。

    请求Body定义支持输入JSON和XML类型的Body描述,相当于一个请求Body的示例,以供API调用者参考格式。

  3. 返回内容定义区域,输入正常返回结果示例异常返回结果示例,以便API调用者参考和编写API返回结果解析代码。

  4. 错误码定义区域,填写调用API时出现的错误码错误信息解决方案,以便API调用者参考并自行查找错误原因。

  5. 单击工具栏中的保存图标。

    配置API后,您可以对其进行测试。详情请参见测试API

    测试成功后,单击右上方的提交

    在API编辑页面的右侧导航栏中,单击版本,找到待申请版本单击申请发布跳转到申请页面,申请类型默认为发布数据服务API,填写申请原因后单击申请权限完成发布申请。

    说明

    工作空间定义审批流后需要走流程审批才可以发布API,详情请参见:审批中心概述

    发布API后,服务资源组的配置即可在调用API时生效。

    您还可以在服务开发页面左侧目录树中对目标API进行克隆和删除等操作。您也可以在服务管理页面,展开API列表,查看已发布API的详情。详情请参见查看、删除、移动、克隆、批量操作、代码搜索API