检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API接口 如何开放API接口 如何进行接口鉴权 如何自定义错误码 如何控制接口访问权限 父主题: 经典版开发指导
源。 在接口列表中,单击接口后的,可查看定义的API信息。 单击“测试一下”,可模拟API接口调用。 图5 API接口请求参数信息 图6 API接口返回参数信息 API接口的请求参数和返回消息体,为绑定的资源(如脚本,服务编排等)所配置的入参和出参。 父主题: API接口
个新的资源。 返回“集成”页面,单击已创建接口后的,选择“查看”,进入接口预览页面。 单击接口后的,可查看定义的API信息。 单击“测试一下”,可模拟API接口调用。 图2 API接口请求参数信息 图3 API接口返回参数信息 API接口的请求参数和返回消息体,为绑定的资源(如脚本,服务编排等)所配置的入参和出参。
API 数据模块 元数据 服务编排 脚本 BPM 导入导出 连接器
client_secret:鉴权的密钥。 根据鉴权ID和鉴权密钥调用接口“/baas/auth/v1.0/oauth2/token”获取access_token。 表2 接口基本信息 接口名称 接口路径 接口协议 接口方法 token /baas/auth/v1.0/oauth2/token
预置API 脚本中预置的API 标准页面中预置的API 高级页面中预置的API
查询应用页签的列表。 服务编排 服务编排接口,包括编排Flow和查看服务编排运行实例两个接口。 表3 服务编排接口 API 说明 编排Flow 编排某个服务编排。 查看服务编排运行实例 查询服务编排信息。 脚本 脚本接口,包括运行、调试和获取脚本签名信息等接口。通过这些接口,您可以运行脚本、对脚本进行调试等。
配置API 使用说明 原生服务旨在帮助您在AstroZero平台上或外部系统,调用已开发好的服务。为了完成调用,需要知道服务开放了哪些接口,以及这些接口的请求参数、返回参数,完成设计API后,可在服务编排中进行调用,也可将API再封装为自定义公共接口,供外部系统调用自定义公共接口。
如何调用API 构造请求 认证鉴权 返回结果
功能介绍 运行脚本,该接口是同步接口(同步接口是指调用后,会等待函数执行结束后,才返回结果)。满足输入参数条件后执行该脚本,不会在控制台打印出日志,但会输出运行结果。 在脚本保存成功和输入参数正确的情况下,可以运行该脚本,但该接口目前已很少使用(可以用custom API运行脚本)。 URI
在连接器详情页面,单击测试中的某个接口,再单击“测试一下”,可模拟API接口调用。 以“自然语言处理基础服务”中的“RunNer”接口为例。 图2 单击“RunNer”接口 图3 API接口请求参数信息 请务必按照“示例模型”中的格式配置接口请求参数,各接口请求参数配置说明请参见各服务的API参考,如《自然语言处理基础服务接口说明》。
脚本中预置的API AstroZero平台的脚本引擎采用TypeScript语言。脚本执行时,TypeScript语言会被翻译成JavaScript语言,由JavaScript引擎执行。 在JavaScript es5的官方标准库外,AstroZero还扩展了10+预置标准库(即
标准页面中预置的API 在开发标准页面时,可以通过编写JS代码,来实现页面组件与后台接口之间的交互。如图1所示,在编写JS代码时,可直接使用系统预置的API。 系统预置的API代码结构样例如下,提供事件上下文context,用于封装常用的对象及API。 context ├──$app
述函数,以此实现不同功能的桥接器。自定义桥接器中常用的API如表2所示,在经典版应用设计器左侧列表中,单击,选择“高级页面 > 桥接器模板”,下载模板解压后可查看API调用示例。 表2 自定义桥接器中常用的API列表 API名称 详细说明 init() 桥接器初始化函数,在该函数
如何控制接口访问权限 什么是业务权限凭证 业务权限凭证用于控制接口的访问权限。AstroZero提供了两种方式对API接口访问权限的控制:配置自定义接口前置脚本和配置API接口的业务权限凭证。优先通过自定义接口前置脚本进行权限验证,根据脚本的返回值判断下一步的操作。 对于配置了业
构造请求 本节介绍REST API请求的组成,并以使用OAuth 2.0协议的客户端鉴权模式获取用户access_token为例说明如何调用API,该API获取access_token,access_token可以用于调用其他API时鉴权。 请求URI 请求URI由如下部分组成:
client_secret:鉴权的密钥。 根据鉴权ID和鉴权密钥调用接口“/baas/auth/v1.0/oauth2/token”,获取access_token。 表2 接口基本信息 接口名称 接口路径 接口协议 接口方法 token /baas/auth/v1.0/oauth2/token
在连接器详情页面,单击测试中的某个接口,再单击“测试一下”,可模拟API接口调用。 以“自然语言处理基础服务”中的“RunNer”接口为例。 图3 单击“RunNer”接口 图4 API接口请求参数信息 请务必按照“示例模型”中的格式配置接口请求参数,各接口请求参数配置说明请参见各服务的API参考,如《自然语言处理
单击对应的连接器名称,在右侧“API接口”页签单击“同步API”,将ROMA Connect上发布并授权的API直接同步到AstroZero。 同步后,在“API接口”页签中,可查看到“获取人员信息”API。 图6 获取人员信息API 单击API名称,可查看API具体信息,包括基本信息、消息头入参、输入和输出参数。
用。本章节中创建了2个业务脚本,因此需要对应创建2个公共接口,供前端页面调用。 创建公共接口的入口:在APP视图下,单击下方“服务”,即可进入公共接口创建页面。 图1 创建公共接口入口 图2 公共接口基本信息 图3 公共接口URL 父主题: 背景和原理