华为云用户手册

响应体（JSON）检查 检查响应体（JSON）中对象字段的值。例如： 响应体结构如下： 检查响应体对象中字段名为“status”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用下标确定对象，下标从0开始）。例如： 响应体结构如下： 检查响应体“result”数组的第1个元素对象字段名为“userId”的值，检查点配置如下： 检查响应体（JSON）中某个数组的对象的字段值（数组条件采用模糊匹配功能确定对象）。例如： 响应体结构如下： a.检查响应体“result”数组下“name”是“啤酒”的所有对象取第1个之后获取id的值，检查点配置如下： 当获取的数组下的对象只有一个，“[0]”可以省略，示例中的表达式可以写为“result[name==啤酒].id”。 b.检查响应体“result”数组下“name”是“啤酒”的并且“obj”对象下属性“a”的值是“2”的对象的id值，检查点配置如下：

比较符说明 支持以下比较类型： 比较类型 比较符 是否需要填入值 举例 数字比较 等于(数字) 不等于(数字) 大于等于(数字) 小于等于(数字) 大于(数字) 小于(数字) 是 响应码 等于 200 响应码 不等于 200 响应码 大于等于 200 响应码 小于等于 200 响应码 大于 200 响应码 小于 200 字符串比较 等于(字符串、区分大小写) 不等于(字符串、区分大小写) 等于(字符串、不区分大小写) 包含(字符串) 不包含(字符串) 是 响应体中的属性param1 等于 test 响应体中的属性param2 不等于 test 响应体中的属性param3 等于 TEST 响应体中的属性param4包含 tri 响应体中的属性param5不包含 tri 正则比较 正则表达式 是 响应体中的属性param1 正则表达式 ^[A-Za-z0-9]{1,32}$ 通用比较 是空（该字段是否为空，即是否没有该字段） 不是空（该字段是否不为空，即是否有该字段） 否 响应体中的属性param1 是空 响应体中的属性param2 不是空 Json数组比较 JSON数组为空数组（json数组是否为空数组） JSON数组为非空数组（json数组是否为非空数组） 否 响应体中的属性param1 JSON数组为空数组 响应体中的属性param2 JSON数组为非空数组 JSON数组的大小（json数组的大小是否为...） 是 响应体中的属性param1 JSON数组的大小 类型比较 是JSON类型（是否是json对象类型） 是JSON数组类型（是否是json数组类型） 否 响应体中的属性param1 是JSON类型 响应体中的属性param2 是JSON数组类型 Json对象比较 JSON等于（json等于） 是 响应体中的属性param1 JSON等于 {"name":"zhangsan"}

检查点说明 测试检查点即请求结果的断言，通过检查接口响应是否符合预期，判定系统是否满足预期。 在接口自动化用例中，测试步骤的“检查点”页签中可以定义测试检查点。 检查点内容包括属性、比较符和目标值定义。 字段 说明 重试次数 如果检查点失败，重新执行该测试步骤的次数，重试次数范围：0~5的正整数。 重试间隔 如果检查点失败，每次重试的间隔时长，单位为ms，重试间隔范围：0~10,000的正整数。 来源 被检测字段的来源，如响应体（JSON）、响应头、响应码、变量。 属性 若来源是响应码，属性可为空。详细介绍请参见响应码检查。 若来源是响应头，属性为响应头中字段的名称。详细介绍请参见响应头检查。 若来源是响应体（JSON），属性有两种填写方法： 普通提取表达式（非“$”开头），例如“item.name”。 取字段中的值，支持嵌套取值。详细介绍请参见响应体（JSON）检查。 从响应体中提取数组时，下标可以是数字，也可以是“key:value”表达式，详细介绍请参见示例：根据给定的key:value从响应体中获取字符串。 JsonPath表达式(“$.”或“$[”开头)，例如“$.store.book[0].title”。 详细介绍请参见示例：根据JsonPath从响应体中获取数据。 若来源是变量，属性为全局变量，局部变量，响应提取后的变量。详细介绍请参见变量检查。 高级提取类型 可选项，使用高级提取类型，辅助提取检查点信息，若选择不涉及，则视为不使用额外的方式匹配。 目前有两种方式： 字符串提取，也就是字符串的截取。 正则表达式，即使用正则方式对来源字符串进行过滤。 高级提取类型优先使用字符串提取功能，若不能满足需求可考虑使用正则表达式。 类型值 高级提取类型中所需的参数。 比较符 支持数字、字符串、JSON对象比较、类型比较等多种比较符，详细介绍请参见比较符说明。 目标值 检查点期望值。目标值支持使用内置参数，请参考内置参数了解如何使用内置参数。 例如，检查响应体（JSON格式）中“item.name”字段的第零位（首位）到第四位之间是不是petty，参数配置如下： 字段 值 来源 响应体（JSON） 属性 item.name 高级提取类型 字符串提取 类型值 0、5 比较符 等于(字符串) 目标值 petty

手动导入 通过主页面的“更多功能”选项或单击左上角搜索框旁边的，可以展示当前支持的导入选项，可根据需要选择。 导入文件 选择响应格式的文件并上传，然后选择文件中系统识别出来的接口和数据模型导入。 一个文件导入后，将会视为一个根目录，一个根目录中不允许存在URL相同的接口。 Postman支持Collections和Environment数据集ZIP包的全量导入，也支持单个Collection文件导入。 Postman支持接口和接口用例的前置脚本及后置脚本导入。 导入URL 选择“导入Swagger URL”，输入URL，即可完成文档导入。 通过Swagger URL导入时，需要填写json数据文件的URL，而非Swagger UI的URL。

新建变量 在“环境参数”页面，单击，即可添加一个变量，根据需要填写变量信息： 参数项 说明 名称 当前环境变量参数名，可使用“$${参数名}”形式进行引用。 类型 包括：文本、随机字符串、随机整数、时间戳、格式化时间戳、生成UUID、Base64编码、MD5哈希值、密码或认证信息、SHA512编码。 值 当前环境变量的值，支持加密显示。 描述 根据不同类型，自动添加默认描述，也可根据设计需要自定义描述。 敏感变量 勾选为敏感变量后，云测对参数值加密存储，在测试结果日志中使用星号覆盖处理。敏感数据类型适用并不限于个人信息、鉴权信息等，如：姓名、地址、用户名等。 动态变量 动态参数的值可以在用例执行过程中被赋值。动态参数初始值可为空，被赋值之后，此处显示的是最新值。 动态参数赋值方法：在用例测试步骤“响应提取”的“赋值给环境动态参数”中设置后，测试执行时，响应提取的内容将被赋值给动态参数。

执行流程 CodeArts API提供基于JavaScript的脚本引入，通过脚本可以实现在快捷调试或接口请求时添加动态行为。脚本执行流程如图： CodeArts API兼容Postman脚本语法，可以将Postman脚本迁移到CodeArts API中使用。 CodeArts API脚本能力仅限于快捷调试、接口调试、接口调试用例。 接口的前置脚本与后置脚本支持配置多个，并按照配置顺序执行。 CodeArts API支持脚本输入提示。 父主题： 脚本能力

参数使用 环境参数可以用于整个项目，如：快捷调试的参数、URL，测试步骤的参数、检查点、变量、URL等都可以引用环境参数。 环境参数的引用形式为“$${参数名}”，如：参数名为“hostname”，则可以使用“$${hostname}”来引用该参数。可以按环境上下文配置环境参数，如：类生产环境中hostname=stage.example.com，生产环境中hostname=prod.example.com。测试执行时可选择环境执行。

操作步骤 用户获取“用户访问 域名 ”，域名在管理员添加用户时，会通过短信或邮件的形式告知用户，添加用户详情请参考添加企业成员。或您可以直接登录开天工作台用户工作台。 登录方式有两种，一种是输入用户名和密码，另一种是输入手机和验证码，如图1所示，然后单击“登录”，进入用户门户首页。 图1 企业用户登录 通过管理员手动添加企业成员的方式创建的账号，首次登录或者未设置密码时，只可通过手机验证码的方式登录，登录后请根据弹窗提示前往设置密码，如图2所示。设置密码后，下次才可使用账号密码登录。 图2 设置密码 单击需要访问的应用，进入应用系统。 若您想了解更多功能，可参考《用户指南》。

计费概述 通过阅读本文，您可以快速了解开天工业工作台（MIW）的计费模式、计费项、续费、欠费等主要计费信息。 计费模式 工业工作台提供包年这一种计费模式。包年是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前，您必须确保帐户余额充足。关于包年计费模式的详细介绍请参见计费模式概述。 计费项 工业工作台的计费项由实例版本套餐费用、扩容包费用组成。关于计费项的详细介绍，请参考计费项。 变更套餐版本 在购买开天工业工作台服务后，如果发现当前规格套餐无法满足业务需求，您可以变更套餐规格。详情请参见变更计费模式。 续费 包年服务在到期后会影响工作台的正常使用。如果您想继续使用工业工作台，需要在规定的时间内为工业工作台进行续费，否则资源将会自动释放，数据也可能会丢失。续费包括手动续费和自动续费两种方式，您可以根据需求选择。了解更多关于续费的信息，请参见续费概述。 欠费 对于包年的工业工作台服务，用户已预先支付了版本费用，因此在账号出现欠费的情况下，已购买的应用平台版本仍可用。详细介绍请参见欠费说明。 停止计费 当工业工作台不再使用时，可以将他们退订或删除，从而避免继续收费。详细介绍请参见停止计费。

续费相关的功能 包年开天工业工作台服务续费相关的功能如表1所示。 表1 续费相关的功能 功能 说明 手动续费 包年开天工业工作台服务从购买到被自动删除之前，您可以随时的MIW总览页面为开天工业工作台服务续费，以延长开天工业工作台服务的使用时间。 自动续费 开通自动续费后，开天工业工作台服务会在每次到期前自动续费，避免因忘记手动续费而导致资源被自动删除。 在开天工业工作台服务生命周期的不同阶段，您可以根据需要选择一种方式进行续费，具体如图1所示。 图1 MIW服务生命周期 开天工业工作台服务从购买到到期前，处于正常运行阶段，资源状态为“运行中”。 到期后，资源状态变为“已过期”。 到期未续费时，开天工业工作台服务首先会进入宽限期，宽限期到期后仍未续费，资源状态变为“已冻结”。 超过宽限期仍未续费将进入保留期，如果保留期内仍未续费，资源将被自动删除。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 在开天工业工作台服务到期前均可开通自动续费，到期前7日凌晨3:00首次尝试自动续费，如果扣款失败，每天凌晨3:00尝试一次，直至开天工业工作台服务到期或者续费成功。到期前7日自动续费扣款是系统默认配置，您也可以根据需要修改此扣款日。

变更配置后对计费的影响 当前包年的工业工作台服务的规格不满足您的业务需要时，您可以发起变更规格操作，变更时系统将按照如下规则为您计算变更费用： 资源升配：新规格价格高于老规格价格，此时您需要支付新老配置的差价。 资源降配：资源降配会影响工作台配置，MIW暂不支持资源降配。 这里以资源升配且无任何优惠的场景为例，假设您在2023/04/08购买了专业版基础型实例，购买时长为1年，计划在2023/04/18变更规格为专业版标准型实例。旧配置价格为14000元/年，新配置价格为54000元/年。计算公式如下： 升配费用=新配置价格*剩余周期-旧配置价格*剩余周期 公式中的剩余周期为每个自然月的剩余天数/对应自然月的最大天数。本示例中，剩余周期=12（4月份剩余天数）/ 30（4月份最大天数）+ 8（5月份剩余天数）/ 31（5月份最大天数）+11（周期剩余月份）=11.6581，代入公式可得升配费用=54000*11.6581÷12-14000*11.6581÷12=33860.33（元） 费用计算结果保留小数点后两位，第三位四舍五入。如遇四舍五入后不足￥0.01，则按￥0.01展示。 实例规格和扩容包单价以售卖页的价格为准。 更多信息请参见变更资源规格费用说明。

到期后影响 图2描述了工业工作台服务各个阶段的状态。购买后，在计费周期内服务正常运行，此阶段为有效期；服务到期而未续费时，将陆续进入宽限期和保留期。 图2 包年MIW生命周期 到期预警 包年工业工作台服务在到期前第7天内，系统将向用户推送到期预警消息。预警消息将通过邮件、短信和站内信的方式通知到华为云帐号的创建者。 到期后影响 当您的包年工业工作台服务到期未续费，首先会进入宽限期，资源状态变为“已过期”。如果您在宽限期内仍未续费工业工作台服务，那么就会进入保留期，资源状态变为“已冻结”，您将无法对处于保留期的包年资源执行任何操作。 保留期到期后，若包年工业工作台服务资源仍未续费，那么服务将无法访问，数据无法恢复。 华为云根据客户等级定义了不同客户的宽限期和保留期时长。 关于续费的详细介绍请参见续费概述。

背景信息 在购买开天工业工作台服务后，如果发现当前规格套餐无法满足业务需求，您可以变更套餐规格。当需要变更到高规格套餐时，需补齐版本差价，剩余服务周期按照剩余天数（不含闰年的2.29号）/365 进行计算（变更当天不算） ，续费时按照变更后的版本进行续费。 升级版本费用 = 升级后版本价格 * 剩余周期 - 未升级版本价格 * 剩余周期 剩余周期计算：按照实际剩余有效期进行换算 示例：2023/11/1客户购买了3年的开天工业工作台服务套餐，有效期截止到2026/11/1，客户在2024/5/1发生变更版本，则剩余周期=2024年剩余周期+2025年剩余周期+2026年剩余周期=244/365+1+305/365=2.50（年）。

适用计费项 以下计费项支持包年。 表1 适用计费项 计费项 详细规格 计费模式 专业版基础型 支持用户数100个。 提供IM即时消息 、 日历 、 通讯录 、 审批 、 待办中心 、 新闻资讯 、 企业公告等办公应用。 提供统一组织 、 统一账号 、 统一授权 、 统一登录 、 应用分组管理 、 支持企业在华为云的自建应用对接。 支持默认门户和定制门户。 支持集成流编排和运行 (40条流)。 包年 专业版标准型 支持用户数500个。 提供IM即时消息 、 日历 、 通讯录 、 审批 、 待办中心 、 新闻资讯 、 企业公告等办公应用。 提供统一组织 、 统一账号 、 统一授权 、 统一登录 、 应用分组管理 、 支持企业在华为云的自建应用对接。 支持默认门户和定制门户。 支持集成流编排和运行 (80条流)。 包年 专业版增强型 支持用户数1000个。 提供IM即时消息 、 日历 、 通讯录 、 审批 、 待办中心 、 新闻资讯 、 企业公告等办公应用。 提供统一组织 、 统一账号 、 统一授权 、 统一登录 、 应用分组管理 、 支持企业在华为云的自建应用对接。 支持默认门户和定制门户。 支持集成流编排和运行 (200条流)。 包年 扩容包 1个扩容包包含100个用户数和10条集成流。 说明： 扩容包不可单独购买。当实例规格为专业版基础型和专业版标准型时，支持订购扩容包。 包年 假设您计划购买开天工业工作台服务，在购买工作台页面底部，您将看到所需费用的明细，如图1所示。 图1 配置费用示例 配置费用包括以下部分： 实例版本套餐：根据所选套餐和购买时长计算的费用。 扩容包：根据是否购买扩容包、扩容包数量和购买时长计算的费用。 仅专业版基础型和专业版标准型支持订购扩容包，且扩容包的购买时长与实例版本套餐购买时长一致。

适用场景 包年计费模式需要用户预先支付一定时长的费用，适用于长期、稳定的业务需求。以下是一些适用于包年计费模式的业务场景： 稳定业务需求：对于长期运行且资源需求相对稳定的业务，如企业官网、在线商城、博客等，包年计费模式能提供较高的成本效益。 长期项目：对于周期较长的项目，如科研项目、大型活动策划等，包年计费模式可以确保在整个项目周期内资源的稳定使用。 业务高峰预测：如果能预测到业务高峰期，如电商促销季、节假日等，可提前购买包年资源以应对高峰期的需求，避免资源紧张。 数据安全要求高：对于对数据安全性要求较高的业务，包年计费模式可确保资源的持续使用，降低因资源欠费而导致的数据安全风险。

计费示例 假设您在2023/03/08 15:50:04购买了包年的工业工作台服务，购买时长为一年，并在到期前手动续费1年，则： 第一个计费周期为：2023/03/08 15:50:04 ~ 2024/03/08 23:59:59 第二个计费周期为：2024/03/08 23:59:59 ~ 2025/03/08 23:59:59 您需要为每个计费周期预先付费，计费公式如表2所示，其中扩容包为可选项。 表2 计费公式 实例版本 计费公式 专业版基础型 （实例规格单价+订购扩容包单价 * 扩容包数量） * 购买时长 专业版标准型 （实例规格单价+订购扩容包单价 * 扩容包数量） * 购买时长 专业版增强型 实例规格单价 * 购买时长

计费说明 开天工业工作台的计费项由实例规格费用、购买时长、扩容包数量和扩容包费用组成。具体内容如表1所示。 标 * 的计费项为必选计费项。 表1 开天工业工作台计费项 计费项 计费项说明 适用的计费模式 计费公式 * 实例规格 开天工业工作台提供的实例版本有：基础版、专业版基础型、专业版标准型、专业版增强型，您可以根据实际业务需要按需选择，实例详细规格可参考表1。 其中基础版为免费使用版本，免费使用6个月后，用户可根据实际情况选择专业版基础型、专业版标准型或专业版增强型。 如果您当前使用的实例版本不能满足需要，工业工作台服务支持变更配置，例如从“专业版基础型”升级到“专业版标准型”，对现有业务没有影响。 包年 实例规格单价 * 购买时长 实例规格单价以售卖页的价格为准。 扩容包 1个扩容包包含100个用户数和10条集成流，您可以根据实际业务需要按需选择。 扩容包不可单独购买。当实例规格为专业版基础型和专业版标准型时，支持订购扩容包，扩容包购买时长与套餐一致。 包年 扩容包单价 * 购买时长* 购买个数 扩容包单价以售卖页的价格为准。

附录2-呼叫拆线点说明 拆线点 拆线点描述 0 接通后主动挂机 100 放音收号时系统接收到的号码为空，若要进行收号，请在语音通知内容播放完毕后的5秒之内进行按键操作 501 录音创建会议失败 502 录音创建会议超时 503 录音主叫加入会议失败 504 录音主叫加入会议超时 505 录音增加录音端点失败 506 录音增加录音端点超时 507 启动录音失败 508 启动录音超时 509 放录音提示音失败 510 放录音提示音超时 512 录音VCU倒换释放呼叫 513 呼叫超时 514 振铃超时 515 远端用户主动Cancel 516 本端用户主动Cancel 517 平台响应超时 518 远端用户呼叫失败，请结合Q850原因值分析 519 本端用户呼叫失败(OXX)，请结合Q850原因值分析 520 本端用户呼叫失败(18X)，请结合Q850原因值分析 521 远端呼叫还未振铃已经拆线 522 语音端口不足 524 放音文件不存在 526 静音失败 527 取消静音失败 528 限制呼叫非特定前缀的号码 529 appkey不存在 530 forward前主叫挂机 539 录音流程未完成，主叫主动挂断电话 540 录音流程未完成，被叫主动挂断电话 541 被叫接通后和主叫的重协商失败 542 录音超时释放呼叫 550 本端呼叫振铃失败 551 点击呼叫本端收到OXX消息 552 远端振铃时本端用户挂机 553 远端还未振铃时本端用户挂机 400~699 在对端没有返回Q850原因值时，直接用SIP消息码（如404：NOT FOUND） 1001 坐席主动挂机 1002 用户主动挂机 1003 SP调用总机释放接口挂机 1004 发起点击外呼后，坐席进行盲转并挂机 2801 IVR放音失败 2802 IVR规则无效 2803 IVR按键超过最大次数 2805 IVR不在服务时间-1 2806 IVR不在服务时间-2 2810 未配置MRF 2811 未配置I CS CF 2812 放音超时 2825 满意度调查结束-1（配置满意度结束音） 2829 拨分机号被叫忙或者无应答 2831 企业呼入License受限 2837 放音失败 2838 INVITE超时释放 2847 总机选线无可用坐席 2853 坐席不可用，拒接呼入 2863 留言创建录音失败 2868 企业已停机 2871 动态ivr等待sp指令超时 2901～2914 录音失败 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 显示号码呼叫频次管控 7004 被叫黑名单呼叫管控 7005 主叫黑名单呼叫管控 7100 app信息不存在 7105 业务类型不匹配 7106 APP未申请个人小号能力 7107 安全管控提示音放音失败 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功，可能包含以下场景： 开发者/应用/固话号码呼叫频次管控：若使用的是95号码，请重新申请固话，（流程：请先添加应用，再参考添加企业完善企业信息，最后参考订购号码申请固话号码）。其他情况请联系华为云客服处理 线路故障/运营商故障：请拨打400电话联系华为云客服处理 被叫关机/无应答/用户正忙等：请核实被叫手机终端是否处于正常状态 8002 接续用户时对端返回失败放音 8003 用户振铃超时 8004 用户振铃时挂机 8005 TTS 转换失败 8006 放音文件不存在 8007 给用户放音失败 8008 给用户放音收号失败，若要进行收号，请在语音通知内容播放完毕后的5秒之内进行按键操作 8009 接通前主叫用户主动挂机 8010 超过通话最大时长挂机 8011 内部错误 8012 无效的app_key 8015 给用户录音失败 8017 客户指示挂机 8018 业务无权限 8020 业务异常 8100 被叫号码不存在 8101 被叫无应答 8102 被叫用户正忙（被叫正在通话、振铃等） 8103 被叫用户暂时无法接通 8104 被叫已关机（被叫处于关机、飞行模式、无网络等状态） 8105 被叫挂机或被叫已停机 8106 主叫号码不存在 8107 主叫无应答 8108 主叫用户正忙（主叫正在通话、振铃等） 8109 主叫用户暂时无法接通 8110 主叫已关机（主叫处于关机、飞行模式、无网络等状态） 8111 主叫挂机或主叫已停机 父主题： 附录

附录1-Q850原因值说明 原因值 原因值描述 0 不涉及 1 无法找到号码 2 无法路由到网络 3 无法路由到目的地 4 发送特殊消息 5 中继前缀出错 6 通道无法接入 7 已经建立频道 8 抢先占有 9 抢先占有保留 16 正常呼叫清除 17 用户忙 18 无应答 19 无用户应答 20 用户不可及 21 拒绝呼叫 22 号码已改变 23 重定向 25 交换路由错误 26 无用户准许 27 目标无序 28 非法号码格式 29 设备拒绝 30 状态查询 31 正常 34 路由不可达 38 网络状态不好 39 服务链接不上 40 链接进行中 41 暂时失败 42 设备拥塞 43 信息丢弃 44 通道无法接入 46 呼叫阻塞 47 无可用资源 49 品质无效 50 设备没预订 53 闭合群OCB呼出受限 55 闭合群ICB呼入受限 57 无权限发送 58 发送无效 62 等级不一致 63 服务无效 65 发送无法执行 66 通道无法执行 69 设备无效 70 发送有效 79 CV服务没设置 81 引用非法值 82 通道不存在 83 ID不存在 84 呼叫ID不存在 85 无呼叫等待 86 隐藏号码呼叫 87 CUG无成员 88 目标冲突 90 CUG不存在 91 无效网络 95 无效信息 96 非托管元素 97 类型不存在 98 信息没执行 99 信息单元不存在 100 无效的信息单元 101 呼叫状态不一致 102 定时器超时 103 参数不存在 110 消息中带有未识别的参数 111 协议错误 127 未指定的交互 父主题： 附录

通话挂机原因值说明 通话挂机原因值 原因值描述 0 接通后主动挂机 7001 开发者呼叫频次管控 7002 应用呼叫频次管控 7003 固话号码呼叫频次管控 7004 被叫黑名单呼叫管控 7108 用户状态已冻结 7109 语音端口不足 8000 内部错误 8001 用户未接续成功，可能包含以下场景： 开发者/应用/固话号码呼叫频次管控：若使用的是95号码，请重新申请固话，（流程：请先添加应用，再参考添加企业完善企业信息，最后参考订购号码申请固话号码）。其他情况请联系华为云客服处理 线路故障/运营商故障：请拨打400电话联系华为云客服处理 被叫关机/无应答/用户正忙等：请核实被叫手机终端是否处于正常状态 8002 接续用户时对端返回失败放音 8003 用户振铃超时 8004 用户振铃时挂机 8005 TTS转换失败 8006 放音文件不存在 8007 给用户放音失败 8008 给用户放音收号失败，请在语音通知内容播放完毕后的5秒之内进行收号操作 8009 接通前主叫用户主动挂机 8010 超过通话最大时长挂机 8012 无效的app_key 8015 给用户录音失败 8017 用户指示挂机 8018 业务无权限 8020 业务异常 8100 被叫号码不存在 8101 被叫无应答 8102 被叫用户正忙 8103 被叫用户暂时无法接通 8104 被叫已关机 8105 被叫挂机或被叫已停机 父主题： 附录

API请求地址 API请求地址由“APP接入地址”和“访问URI”组成，数据来源如下： 参数 来源 示例 APP接入地址 登录管理控制台，从语音通话“应用管理”页面获取。 https://rtccall.cn-north-1.myhuaweicloud.cn:443 访问URI 从各API接口页面中的“接口类型说明”中获取。 语音回呼场景API：/rest/httpsessions/click2Call/v2.0 综上，API请求地址示例如下： 设置语音回呼： https://rtccall.cn-north-1.myhuaweicloud.cn:443/rest/httpsessions/click2Call/v2.0

API列表 API名称 API功能 语音回呼场景API 主叫用户通过应用拨打被叫用户，语音通话平台呼叫主叫和被叫，使主叫和被叫能够互相通话。 终止呼叫场景API 实现通话双方终止呼叫。 语音回呼呼叫状态通知API 语音通话平台向SP推送接收语音通话业务用户呼叫时的状态信息，如呼入、呼出、振铃、应答、挂机等状态的信息。 语音回呼话单通知API 通话结束后，语音通话平台向SP推送通话的话单信息。 获取录音文件下载地址API 获取通话后的录音文件下载地址。

概述 欢迎使用语音通话服务（VoiceCall）。语音通话服务以云服务的方式提供语音通信能力，支持语音回呼、语音验证码、语音通知。方便快捷，拨通率高；安全可靠，防盗取，防攻击；性能稳定，支持大容量、高并发 本文档提供了语音通话API的描述、参数说明及示例等内容。支持的全部操作请参见API接口使用说明。 在调用API之前，请确保已经充分了解语音通话相关概念及功能详解，详细信息请参见语音通话“产品介绍”。 录音功能涉及个人用户通信内容。建议您只有在所适用法律法规允许的目的和范围内方可启用相应的功能。在使用、存储用户通信内容的过程中，您应采取足够的措施以确保用户的通信内容受到严格保护。 录音功能会涉及用户的通信内容，请确保更换的录音提示音满足当地法律法规的要求。

结果码说明 请根据以下结果码进行调测，如果有疑问，可联系管理员进行确认。 表7 响应结果码 响应码 结果码 英文描述 中文描述 处理方法 301 - - - 成功响应，请从Location头域中获取录音文件下载地址。 400 1023006 Authorization not contained in the HTTP header. HTTP消息头未找到Authorization字段。 请检查HTTP消息头中是否携带了Authorization字段。 1023007 realm not contained in Authorization. Authorization字段中未找到realm属性。 请检查Authorization字段中的是否携带了realm属性。 1023008 profile not contained in Authorization. Authorization字段中未找到profile属性。 请检查Authorization字段中的是否携带了profile属性。 1023009 The value of realm in Authorization must be SDP. Authorization中realm属性值应该为“SDP”。 请检查Authorization字段中的realm属性值是否为“SDP”。 1023010 The value of profile in Authorization must be UsernameToken. Authorization中profile属性值应该为“UsernameToken”。 请检查Authorization字段中的profile属性值是否为“UsernameToken”。 1023011 The value of type in Authorization must be app_key. Authorization中type属性值应该为“Appkey”。 请检查Authorization字段中的type属性值是否为“Appkey”。 1023012 type not contained in Authorization. Authorization字段中未找到type属性。 请检查Authorization字段中是否携带了type属性。 1023033 HTTP header not found X-AKSK field. HTTP头未找到X-AKSK字段。 请检查HTTP消息头中是否携带了X-AKSK字段。 1023034 UserName not contained in X-AKSK. X-AKSK字段中未找到UserName属性。 请检查X-AKSK字段中的是否携带了Username属性。 1023035 Nonce not contained in X-AKSK. X-AKSK字段中未找到Nonce属性。 请检查X-AKSK字段中的是否携带了Nonce属性。 1023036 Created not contained in X-AKSK. X-AKSK字段中未找到Created属性。 请检查X-AKSK字段中的是否携带了Created属性。 1023037 PasswordDigest not contained in X-AKSK. X-AKSK字段中未找到PasswordDigest属性。 请检查X-AKSK字段中的是否携带了PasswordDigest属性。 1023038 UsernameToken not contained in X-AKSK. X-AKSK中没有携带UsernameToken。 请检查X-AKSK字段中的是否携带了UsernameToken属性。 401 1010010 Invalid digest. PasswordDigest校验失败。 请检查PasswordDigest字段填写是否正确。 1010013 Time out limit. 时间超出限制。 请确认X-AKSK鉴权时，生成随机数的时间与发送请求时的本地时间不能相差太大（具体差值请与管理员确认）。 403 1010002 Invalid request. 非法请求。 请检查请求携带的参数格式是否都合法。 1010003 Invalid app_key. 无效的app_key。 检查请求携带的app_key是否填写正确，app_key从应用管理页面获取，若填写正确，请在应用管理页面检查请求携带的app_key所属应用状态是否正常。 1010007 The ativeState of User is not ACTIVATING. 用户状态未激活。 请检查app_key所属的华为云账户是否处于欠费状态，若处于欠费状态，请参考华为云账户充值完成充值，若没有处于欠费状态，请联系管理员处理。 1012012 Application does not open recording function. 应用未开启录音功能。 请确认请求携带的app_key是否开启了录音功能。 1012007 The record does not exist. 记录不存在。 请确认fileName参数的填写是否正确。 1011006 Under traffic control status 请求者（IP、手机号码）处于流控状态下。 请稍等一分钟再试。 1020166 The app client ip is not in ip white list. 请求发送方app IP不在白名单列表中。 联系管理员检查IP白名单是否配置正确。 1020176 Authentication failed, try again later 鉴权失败，稍后重试 IP因鉴权失败次数过多导致被拉黑，请30分钟后重试，或联系管理员放通该IP。 500 1010001 Internal system error. 系统错误。 请联系管理员处理。 1023001 Internal error. 内部错误。

接口示例 请求示例 GET /rest/provision/voice/record/v1.0? fileName=1200_366_0_20161228102743.wav&recordDomain=huawei HTTP1.1 content-type: application/json;charset=UTF-8authorization: AKSK realm="SDP",profile="UsernameToken",type="Appkey"x-aksk: UsernameToken Username="ZRBRz4bAXoFgEH7o4Ew308eXc1RA",PasswordDigest="****",Nonce="ac1c911c4792492687f8f6b2264a491e",Created="2018-05-26T00:35:30Z"content-length:xx 响应示例 HTTP/1.1 301 Moved Permanently Location: **** Connection: close Content-Length: 0

使用说明 前提条件 已通过“应用管理”页面获取APP_Key，APP_Secret和APP接入地址。 已通过“呼叫状态和话单通知API”获取了录音文件名。 注意事项 响应返回的录音下载地址有效期为7天。请在七天期限内调用该接口获取下载地址并下载录音。 调用获取录音文件下载地址接口需要把connection设置为不支持重定向，再从Location头域中获取到录音文件的下载地址。 若connection设置为支持重定向，则重定向后平台返回的是录音文件的数据流。 使用限制 无。

请求参数 表2 请求URL参数说明 参数名称 是否必选 参数类型 默认值 说明 fileName 是 String(1-128) 无 录音文件名。通过“呼叫状态和话单通知API”的recordObjectName参数获取。 recordDomain 是 String(1-128) 无 录音文件存储的服务器域名，通过“呼叫状态和话单通知API”的recordDomain参数获取。 表3 请求Headers参数说明 参数名称 是否必选 参数类型 说明 Content-Type 是 String 固定填写为application/json;charset=UTF-8。 Authorization 是 String 固定填写为AKSK realm="SDP",profile="UsernameToken",type="Appkey"。 X-AKSK 是 String 取值为UsernameToken Username="APP_Key的值", PasswordDigest="PasswordDigest的值", Nonce="随机数", Created="随机数生成时间"。 PasswordDigest：根据PasswordDigest = Base64 (HMAC-SHA256 (Password，Nonce + Created))生成。其中，Password为APP_Secret的值。Nonce、Created、Password直接进行字符串拼接即可，无需包含+号和空格。 Nonce：客户发送请求时生成的一个随机数，长度为1~128位，可包含数字和大小写字母。例如：66C92B11FF8A425FB8D4CCFE0ED9ED1F。 Created：随机数生成时间。采用标准UTC格式，例如：2018-02-12T15:30:20Z。不同编程语言中将UTC时间戳转换为普通时间时使用的格式不同，部分语言可参考表4。 表4 不同编程语言的时间格式 编程语言 时间格式 Java yyyy-MM-dd'T'HH:mm:ss'Z' PHP Y-m-d\TH:i:s\Z Python %Y-%m-%dT%H:%M:%SZ C# yyyy-MM-ddTHH:mm:ssZ Node.js toISOString().replace(/.[0-9]+\Z/, 'Z') 注：Node.js中，使用toISOString()转换后的时间格式去除毫秒后即为本接口要求的时间格式。

API请求地址 API请求地址由“APP接入地址”和“访问URI”组成，数据来源如下： 参数 来源 示例 APP接入地址 登录管理控制台，从语音通话“应用管理”页面获取。 https://rtccall.cn-north-1.myhuaweicloud.cn:443 访问URI 从各API接口页面中的“接口类型说明”中获取。 语音通知API：/rest/httpsessions/callnotify/{version} 综上，API请求地址示例如下： 设置语音通知： https://rtccall.cn-north-1.myhuaweicloud.cn:443/rest/httpsessions/callnotify/{version}

API请求地址 API请求地址由“APP接入地址”和“访问URI”组成，数据来源如下： 参数 来源 示例 APP接入地址 登录管理控制台，从语音通话“应用管理”页面获取。 https://rtccall.cn-north-1.myhuaweicloud.cn:443 访问URI 从各API接口页面中的“接口类型说明”中获取。 语音验证码场景API：/rest/httpsessions/callVerify/v1.0 综上，API请求地址示例如下： 设置语音验证码： https://rtccall.cn-north-1.myhuaweicloud.cn:443/rest/httpsessions/callVerify/v1.0

垃圾邮件有哪些危害？ 电子邮件是当今社会的重要沟通工具之一，如果垃圾邮件泛滥将会对社会的稳定与发展产生严重影响： 降低通信质量：垃圾邮件占用大量网络带宽，影响网络传输速度，容易造成邮件服务器堵塞。 损害收件人利益：垃圾邮件常常包含隐蔽性极强的钓鱼信息，容易导致收件人的信息泄露，进而可能造成收件人被诈骗或商业机密被窃取，而且垃圾邮件反复性强、传播速度快，会耗费收件人大量的时间和金钱进行处理。 散布有害信息：垃圾邮件易被用于传播谣言、色情等有害信息，影响社会治安。