检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
第三次正式发布。包含以下修改点: 新增列出所有应用接口。 新增根据ID查询应用接口。 2021-05-17 第二次正式发布。包含以下修改点: 新增脚本中预置的API接口。 新增标准页面中预置的API接口。 新增高级页面中预置的API接口。 2020-04-30 第一次正式发布。
表1 路径参数 参数 是否必选 参数类型 描述 object_Id 是 String 参数解释: 对象的ID值,可通过调用查询所有自定义对象接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 无 响应参数 表2 响应参数 参数
NER)。 API读: 通过HTTP接口发起读取操作,不影响在服务编排、脚本等发起的操作。 API写:通过HTTP接口发起写操作,不影响在服务编排、脚本等发起的操作。 某些特殊的对象不允许直接访问,如User对象,所有Profile只开放读取功能,增删改都要通过接口来操作。字段权限如下:
表1 路径参数 参数 是否必选 参数类型 描述 object_Id 是 String 参数解释: 对象的ID值,可通过调用查询所有自定义对象接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 无 响应参数 表2 响应参数 参数
测试成功,单击编辑器上方的,启用发布脚本。 创建“查询工单”公共接口 在“我的应用”中,单击“设备维修管理系统”,进入应用。 单击页面下方的“服务”,进入公共接口创建页面。 单击“新建”,创建“查询工单”脚本“HW__queryWorkOrder”的公共接口。 设置接口参数信息:操作名称为“queryWorkOrder”,版本为“1
使用SOAP服务调用SOAP协议接口 创建SOAP Service 创建并启用SOAP Action 在服务编排中,调用SOAP Action 父主题: 集成开发
测试成功,单击编辑器上方的,启用发布脚本。 创建公共接口 参考之前创建公共接口的步骤,创建“删除工单”脚本对应的公共接口。 在设计视图下,单击下方“服务”,进入公共接口创建页面。 图1 创建公共接口入口 在公共接口中,单击“新建”。 图2 公共接口创建 创建“删除工单”脚本对应的公共接口,详细接口信息如表1所示。 表1
状态码 状态码如表1所示。 表1 状态码 状态码 编码 错误码说明 100 Continue 继续请求。 这个临时响应用来通知客户端,它的部分请求已经被服务器接收,且仍未被拒绝。 101 Switching Protocols 切换协议。只能切换到更高级的协议。 例如,切换到HTTP的新版本协议。
参数 是否必选 参数类型 描述 Picklist _id 是 String 参数解释: Picklist实例的ID,可通过调用查询选项列表值集接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 表2 请求参数 参数 是否必选
测试成功,单击编辑器上方的,启用脚本。 创建“生成工单”公共接口 在APP视图下,单击“服务”,进入公共接口创建页面。 图2 创建公共接口入口 单击“新建”,创建“生成工单”脚本“HW__createWorkOrder”的公共接口。 设置接口参数信息:操作名称为“createWorkOrder”,版本为“1
调用。Action是对第三方接口的一个元数据描述,将第三方接口转换成AstroZero可识别的定义,方便AstroZero调用第三方接口。 使用SOAP服务调用SOAP协议接口:当系统需要调用第三方提供的SOAP协议接口时,可以通过配置SOAP Service来实现。SOAP S
错误码 调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时,HTTP请求返回一个4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时,可以联系华为云客服,并提供错误码,以便尽快帮您解决问题。
ro提供了配置权限脚本和配置API接口两种方式来控制API接口的访问权限。建议优先通过权限脚本进行权限验证,根据脚本的返回值判断下一步的操作。 对于配置了业务权限凭证的接口,需要在权限的“业务权限凭证”页签中接入相应的业务权限凭证,才可调用API接口。 若用户(User)没有配置
参数 是否必选 参数类型 描述 Picklist _id 是 String 参数解释: Picklist实例的ID,可通过调用查询选项列表值集接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 表2 请求Body参数 参数 是否必选
业务权限凭证 单击“编辑”,可给接口添加业务权限凭证。 预览测试接口。 在自定义接口列表中,单击接口所在行的,预览接口。 若为公共接口,支持查看接口参数并进行在线测试。若为私有接口,只可查看接口的入参和出参。 单击接口URL后的,可查看接口的参数。 若为公共接口,单击“测试一下”,填写输
参数 是否必选 参数类型 描述 Picklist _id 是 String 参数解释: Picklist实例的ID,可通过调用查询选项列表值集接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 表2 请求参数 参数 是否必选
表1 路径参数 参数 是否必选 参数类型 描述 flow_id 是 String 参数解释: 服务编排实例的id,可通过调用查询Flow对象接口查看(响应消息中的“id”)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 请求参数 表2 请求参数 参数 是否必选
使用Rest服务调用Rest协议接口 当系统需要调用第三方提供的Rest协议接口时,可以通过配置Rest服务来实现。Rest服务是第三方系统提供的,是一组模块化的Rest接口,通过配置第三方提供的Rest服务的URL进行调用。对接Rest服务后,可以为服务添加动作,动作用于将第三方接口转换成Astr
其中,“t__testErrorCode”为自定义错误码名称,请根据实际情况配置。 单击,保存脚本后,单击,启用脚本。 按照定义API接口中操作,绑定上述开发的脚本,进行测试。 图3 自定义错误信息测试 父主题: 开放接口供第三方系统调用
登录应用设计器 背景信息 在调用接口时,如果请求参数中需要填入对象名、服务编排名等,可进入应用设计器查看。 登录应用设计器 进入AstroZero服务控制台。 在主页中,单击“进入首页”,进入AstroZero新版应用开发页面。 图1 应用开发页面 在左侧导航中,单击“应用”,进入应用管理页面。