华为云首页用户手册

ASTRO轻应用 ASTROZERO-配置API:操作步骤

ASTRO轻应用 ASTROZERO-配置API:操作步骤

时间：2024-07-17 13:47:04

ASTRO轻应用 ASTROZERO 如何创建原生服务

操作步骤

在Native Service配置页面，选择“导航”。

图1 单击导航
在“API设计”页签，单击“开始设计API”。
选择“使用模板”，配置基本信息和新URL对应的版本号，单击“创建”。

图2 创建一个新版本
- openApi版本：接口定义需要符合openApi规范，这里配置具体openApi的版本号。
- 选择模板：选择系统预置的模板。
- 版本：输入服务版本号。
- 标题：原生服务API的名称。
创建完成后，单击“新增资源”。
在“增加资源及操作方法”页面，配置相关参数，单击“确认”。

图3 增加资源及操作方法配置页面
- 输入一个新的资源路径（以/开头）：与镜像文件中的接口路径保持一致。
- 方法：调用的方法，如GET（查询）、PUT（增加）、POST（修改）、DELETE（删除）、PATCH（对资源进行部分修改）。
- 操作名称：与镜像文件中的操作名称保持一致。
- 公共接口：若勾选，则只能在公共接口中调用，无法在服务编排和脚本中使用。
- 内容类型：当勾选“公共接口”时，您需要配置内容类型，即请求中的body类型。其中，“application/x-www-form-urlencoded”、“application/xml”、“multipart/form-data”、“text/html”和“text/plain”用于文件上传接口，选择该内容类型，只能调用post类型的方法。
- 描述：描述信息。
单击生成的方法，可以在右侧编辑方法的URL、Header、Response参数，需要和镜像文件中接口的URL参数、Header参数、请求参数、返回参数保持一致。编辑参数后，需要单击参数操作列的，再单击“保存”。
您可参考界面上“/case”、“/case/{CaseId}”两个示例编辑生成的方法。每个方法都需要定义Response参数，否则会部署失败。返回体数据结构在模式对象中定义。

当Body参数和Response参数较多，一些参数可以封装成对象类型的参数，并在“模式对象”页签设置该类型参数，注意“模式对象”页签中参数名与操作中URL参数不能同名。

支持按照操作名称和资源路径单过滤或者组合过滤搜索方法。

图4 编辑方法

图5 定义模式对象
参考4~6，新增其他API方法。
编辑方法完成后，需要手动删除“/case”、“/case/{CaseId}”两个示例，删除示例模式对象。
单击“保存”，创建的自定义接口会出现在页面上。
在页面右上方，单击，可以查看自定义接口中的方法和模型对象。单击，可导出该原生服务下接口定义yaml文件。
单击，发布API。
发布后如果需要修改API，需要单击，取消发布后进行修改，修改后再保存并发布。

已发布的API可能在服务编排中已经使用，如果修改API导致不兼容，请同步修改引用该API的服务编排。

上一篇：ASTRO轻应用 ASTROZERO-表单:属性

下一篇：ASTRO轻应用 ASTROZERO-使用校验器和触发器:为对象配置内嵌触发器

华为云11.11 2核1G 2M 云服务器

29元/年

立即注册领万元上云礼券

抽奖赢11111元免单

续费同价 L实例 2核2G 4M

98元/年

热门域名 1元随心购

1元/年

ASTRO轻应用 ASTROZERO-配置API:操作步骤

意见反馈

0/200

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

推荐文章

解决方案
相关专题