使用配置模式生成数据API简单且容易上手，您不需编写任何代码，通过产品界面进行勾选配置即可快速生成API。推荐对API功能的要求不高或者无代码开发经验的用户使用。
前提条件
已在“管理中心 > 数据连接”页面，完成数据源的配置。
新建API目录
API目录是按一定次序编排记录的API索引，是反映类别、指导使用、检索API的工具，帮助API开发者对API服务进行有效的分类和管理。
1.在DataArts Studio控制台首页，选择实例，点击“进入控制台”，选择对应工作空间的“数据服务”模块，进入数据服务页面。
详见下图： 选择数据服务
2.在左侧导航栏选择服务版本（例如：专享版），进入总览页。
3.进入“开发API > > API目录”页面，单击
。输入新建API目录名称，可新建API目录。
4.对应已成功创建的API目录的操作列，可重新编辑API目录或者管理API。单击“编辑”，可修改API目录名称信息。仅当API处于已创建、已驳回、已下线、已停用的情况下才能进行API修改。
配置API基本信息
1.在DataArts Studio控制台首页，选择实例，点击“进入控制台”，选择对应工作空间的“数据服务”模块，进入数据服务页面。
详见下图： 选择数据服务
2.在左侧导航选择服务版本（例如：专享版），进入总览页。
3.进入“API管理”页面，单击“新建”，填写API基本信息。
详见下表： API基本信息
| 配置 | 说明 |
|---|---|
| API名称 | 支持中文、英文、数字、下划线，且只能以英文或中文开头，3-64个字符。 |
| API目录 | 一个特定功能或场景的API集合，类似文件夹，是数据服务中API的最小组织单元，也是API网关中的最小管理单元。 您可单击“新建”进行新建，也可选择新建API目录已创建的API分组。 |
| 请求Path | API访问路径，例如：/v2/{project_id}/streams。 请求Path即完整的url中，域名之后、查询参数之前的部分，如下图中的“/blogs/188138”。 统一资源定位符url说明  在请求路径中，可以使用大括号{}标识路径中的参数作为通配符。如“/blogs/{blog_id}”表示/blogs后可以携带任何参数，例如“/blogs/188138”和“/blogs/0”均会匹配至/blogs/{blog_id}，由此API统一处理。 此外，相同域名下，不允许重复的请求路径出现。路径参数作为通配符时，名称不具备唯一性，例如“/blogs/{blog_id}”和“/blogs/{xxxx}”，会被视作相同路径。 |
| 参数协议 | 用于传输请求的协议，支持HTTP和HTTPS协议。 HTTP属于基础的网络传输协议，无状态、无连接、简单、快速、灵活、使用明文传输，在使用上较为便捷，但是安全性欠佳。 HTTPS是在HTTP协议上进行了SSL或TLS加密校验的协议，能够有效验证身份以及保护数据完整性。相对的，访问HTTPS的API，需要配置相关的SSL证书或跳过SSL校验，否则将无法访问。 |
| 请求方式 | HTTP请求方式，表示请求什么类型的操作，包含GET、POST等，遵循resultful风格。 GET：请求服务器返回指定资源，推荐使用GET请求。 POST：请求服务器新增资源或执行特殊操作，仅在注册API时使用。POST请求当前不支持body体，而是直接透传。 |
| 描述 | 对API进行简要描述。 |
| 标签 | 对API设置标签。用于标记当前API的属性，创建后可以通过标签快速检索定位API。单个API最多可设置20个标签。 |
| 审核人 | 拥有API的审核权限。 单击“新建”，进入“审核中心>审核人管理”页面，新建审核人。 |
| 安全认证 | API认证方式： APP认证：表示由API网关服务负责接口请求的安全认证，安全级别最高。 IAM认证：表示借助IAM服务进行安全认证，安全级别中等。 无认证：属于无防护的模式，无需认证即可访问，安全级别低，不推荐使用。 |
| 服务目录可见性 | 发布后，所选范围内的用户均可以在服务目录中看到此API。 当前工作空间可见 当前项目可见 当前租户可见 |
| 访问日志 | 勾选，则此API的查询结果将会产生记录并被保留7天，可以在“运营管理>访问日志”处通过选择“请求日期”的方式查看对应日期的日志。 |
| 最低保留期限 | API解绑前预留的最低期限。0表示不设限制。 API进行停用/下线/取消授权时，会通知已授权用户，并为用户预留至少X小时，直到所有授权用户均完成解除或处理，或者到达截止时间，API才会停用/下线/取消授权。 |
| 入参定义 | 配置API请求中的参数，包含资源路径中的动态参数，请求URI中的查询参数和Header参数。 添加入参定义时，如果参数设定为必填，则API在访问时，必须传入指定参数；如果非必填，则在API访问时，未传入的参数，会使用默认值进行代替。 参数大小限制如下： query+path，url最大32KB header，最大128KB body， 最大128KB 以配置资源路径中的动态参数为例进行说明，例如资源路径（请求Path）设置为： /v2/{project_id}/streams，资源路径中的{project_id}为动态参数，需要在此进行配置。 1. 单击“添加”，参数名配置为project_id。 2. 参数位置选择PATH。 3. 类型设置为STRING。 4. 选择性配置示例值和描述。 |
4.配置好API基本信息后，单击“下一步”，即可进入API取数逻辑页面。
配置取数逻辑
“取数方式”选择“配置方式”：
1.选择数据源、数据连接、数据库和数据表，获取到需要配置的表。
说明数据服务仅支持部分数据源，详情请参见 DataArts Studio支持的数据源。您需提前在DataArts Studio管理中心中配置好数据源，数据表支持表名搜索。
2.配置参数字段
选择好数据表之后，单击“参数设置”后的“添加”，添加参数页面自动列出这个表的所有字段，分别勾选需要设置为请求参数、返回参数和排序参数的字段，分别添加到请求参数、返回参数和排序参数列表当中。
添加参数
3.编辑请求参数信息
请求参数主要分为三部分，绑定参数、绑定字段、操作符。在请求参数列表中，需要设置绑定参数和操作符。
- 绑定参数对外开放，是用户访问API时，直接使用的参数。
- 绑定字段对外不可见，是API调用时，实际访问的内容。
- 操作符则是用户访问时，对参数的的处理方式。当前支持的操作符及含义如下：
支持的操作符
| 操作符 | 描述 |
|---|---|
| = | 检查两个操作数的值是否相等，如果相等则条件为真。 |
| <> | 检查两个操作数的值是否相等，如果不相等则条件为真。 |
| > | 检查左操作数的值是否大于右操作数的值，如果是则条件为真。 |
| >= | 检查左操作数的值是否大于等于右操作数的值，如果是则条件为真。 |
| < | 检查左操作数的值是否小于右操作数的值，如果是则条件为真。 |
| <= | 检查左操作数的值是否小于等于右操作数的值，如果是则条件为真。 |
| %like% | %like%表示忽略前后缀，进行字符匹配。 |
| %like | %like表示忽略前缀，进行字符匹配。 |
| like% | like%表示忽略后缀，进行字符匹配。 |
| in | in运算符用于把某个值与一系列指定列表的值进行比较。 |
| not in | in运算符的对立面，用于把某个值与不在一系列指定列表的值进行比较。 |
4.编辑返回参数信息
在返回参数列表中，设置参数的名称、参数类型、示例值和描述。
返回参数主要分为三部分，参数名、绑定字段、参数类型。参数名对外开放，是API返回时，最终展示给用户的参数名称；绑定字段对外不可见，是API调用时，实际返回的内容；参数类型则是API调用时，数据的呈现格式，分为数值型和字符型两类。
5.编辑排序参数信息
在排序参数列表中，设置排序字段是否可选，排序方式和描述。
排序参数主要分为四部分，参数名、字段名称、是否可选以及排序方式。参数名对外开放，是API返回时，最终展示给用户的参数名称；字段名称对外不可见，是API调用时，实际访问的内容；是否可选决定了当前排序条件是否允许移除，勾选则表示可以不使用此参数；排序方式分为升序、降序以及自定义，表示了当前参数允许使用的排序形式。
通过排序参数列表中的操作列的向上、向下和删除按钮，可调整排序参数的顺序或者删除某排序参数。
6.单击“下一步”，设置pre_order_by的值为所有排序参数的描述，以“英文分号”进行分隔。
以如下样例数据为例进行说明：
排序字段对应的参数描述
| 排序字段 | 对应的排序参数描述 |
|---|---|
| id | a:asc 其中，a是参数名，asc代表升序。 |
| name | b:asc b b:desc 其中，b是参数名，因为排序方式是自定义，所以有如上三种参数描述。 |
| age | c:desc 其中，c是参数名，desc代表降序。 |
依据上表，分析得出各个字段对应的排序参数描述，则pre_order_by的设置方式有如下几种情况，包含所有排序参数的描述。
配置pre_order_by
| pre_order_by | 对应的后端order by语句 | 备注 |
|---|---|---|
| a:asc;b;c:desc | order by id ASC, name, age DESC | - |
| b;c:desc | order by name, age DESC | 因a是可选排序字段，所以可以不填。 |
| b:asc;c:desc | order by name ASC; age DESC | b排序方式是自定义，排序时可选择升序。 |
| b:desc;c:desc | order by name DESC; age DESC | b排序方式是自定义，排序时可选择降序。 |
配置排序参数值
说明
pre_order_by是非必填参数，当未配置pre_order_by参数值时，则选取非可选排序字段作为排序的依据。
当配置pre_order_by参数值时，配置类API需严格按照排序参数顺序进行设置。例如
a:asc;b;c:desc ，可行。当设置为b;a:asc;c:desc，则报错。
测试API
完成API参数的配置并保存后，单击左下角的“开始测试”，可进入API测试环节。
填写参数值，单击“开始测试”，即可在线发送API请求，在右侧可以看到API请求详情及返回内容。如果测试失败，请仔细查看错误提示并做相应的修改重新测试。 配置过程中需要注意正常返回示例的设置。
完成API测试之后，单击“确定”，即成功生成了一个数据API。
修改API
生成API后，如果您需要修改API内容，可在“开发API > API目录”或“开发API > API管理”处选择对应API，点击“编辑”按钮进行修改API的相关操作。
说明仅当API处于已创建、已驳回、已下线、已停用的情况下才能进行API修改。
