您可以将已有的API服务注册到DataWorks数据服务中，以实现统一的发布和管理（例如查看API的调用信息、调用日志，管理API标签、版本等），本文为您介绍如何注册API。
注册API
如果您没有API，则需要使用生成API功能。详情请参见通过向导模式生成API。
在服务开发页面，鼠标悬停至
图标，单击注册API。您也可以打开相应的业务流程，右键单击API，选择。
在注册API对话框中，配置各项参数。
参数
描述
API名称
支持中文、英文、数字、下划线（_），且只能以英文或中文开头，4~50个字符。
API Path
API存放的路径，例如/user。
说明支持英文、数字、下划线（_）和连字符（-），且只能以（ /） 开头，不得超过200个字符。
协议
支持HTTP、HTTPS协议。
如果您需要通过HTTPS协议调用API，请您发布API至网关后，在API网关控制台绑定独立域名，并上传SSL证书。详情请参见支持HTTPS。
请求方式
支持GET、POST、PUT和DELETE。
返回类型
支持JSON和XML。
可见范围
包括工作空间和私有：
工作空间：该API对本工作空间内的所有成员可见。
私有：该API仅对API的负责人可见，且暂不支持授权。
说明如果设置可见范围为私有，在目录树中，仅自己可见，工作空间内的其他成员不可见。
标签
从标签列表中选择相应的标签，详情请参见创建及管理API标签。
说明标签名称支持汉字、英文、数字和下划线（_），您最多可以设置5个标签，且每个标签不超过20个字符。
描述
对API进行简要描述，不得超过2000个字符。
目标文件夹
存放API的目录。
单击确认。
配置API
双击打开注册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。具体的可根据您接口服务地址实际路径进行配置。后端超时
设置后端超时时间。
在请求参数定义区域，配置各项参数。
参数
描述
请求参数
您可以单击新增参数，根据页面配置API的请求参数。
其中参数位置支持QUERY、HEAD和BODY。不同的请求方式支持不同的参数位置，请根据页面提供的可选项按需选择。
常量参数
参数值为固定的参数，对调用者不可见。调用API时无需传入常量参数，但后台服务始终接收您在此处配置的常量参数及参数值。
适用于固定某个参数的取值并对调用者隐藏参数的场景。
请求Body定义
仅请求方式为POST和PUT时，会出现该参数。
请求Body定义支持输入JSON和XML类型的Body描述，相当于一个请求Body的示例，以供API调用者参考格式。
在返回内容定义区域，输入正常返回结果示例和异常返回结果示例，以便API调用者参考和编写API返回结果解析代码。
在错误码定义区域，填写调用API时出现的错误码、错误信息和解决方案，以便API调用者参考并自行查找错误原因。
单击工具栏中的
图标。配置API后，您可以对其进行测试。详情请参见测试API。
测试成功后，单击右上方的提交。
在API编辑页面的右侧导航栏中，单击版本，找到待申请版本单击申请发布跳转到申请页面，申请类型默认为发布数据服务API，填写申请原因后单击申请权限完成发布申请。
说明工作空间定义审批流后需要走流程审批才可以发布API，详情请参见：审批中心概述。
发布API后，服务资源组的配置即可在调用API时生效。
您还可以在服务开发页面左侧目录树中对目标API进行克隆和删除等操作。您也可以在服务管理页面，展开API列表，查看已发布API的详情。详情请参见查看、删除、移动、克隆、批量操作、代码搜索API。