swagger 返回map（swagger 返回多个响应类型）



客户端向服务端发送携带文本内容的HTTPS GET方法或POST方法的请求，服务端返回携带合成语音数据的HTTP响应。

语音合成的请求参数如下表所示。

• 如果使用HTTPS GET方法的请求，需要在HTTPS的URL请求参数中设置这些参数。
• 如果使用HTTPS POST方法的请求，需要在HTTPS的请求体（Body）中设置这些参数。

一个完整的语音合成RESTful API GET方法的请求包含以下要素：

• URL

• 请求参数

  参见上述。由URL和请求参数组成的完整请求链接如下所示，在浏览器中打开该链接可直接获取语音合成结果：

• HTTPS GET请求头部

一个完整的语音合成RESTful API POST请求包含以下要素：

• URL

• HTTPS POST请求头部

• HTTPS POST请求体

  HTTPS POST请求体由请求参数组成JSON格式的字符串组成，因此在HTTPS POST请求头部中的Content-Type必须设置为"application/json"。示例如下：

使用HTTPS GET方法和HTTPS POST方法请求的响应是相同的，响应结果都包含在HTTPS的响应体中。响应结果的成功/失败通过HTTPS Headers的字段来区分：

• 成功响应
  • HTTPS Headers的字段内容为，表示合成成功，合成的语音数据在响应体中。
  • HTTPS Header的字段内容为请求任务的task_id。
  • 响应内容为合成音频的二进制数据。
• 失败响应
  • HTTPS Headers没有字段，或者字段内容为，表示合成失败，错误信息在响应体中。
  • HTTPS Headers的字段内容为请求任务的task_id。
  • 响应体内容为错误信息，以JSON格式的字符串表示。如下所示：

  • 错误信息字段如下表

依赖文件内容如下：

示例代码如下：

Java（流式合成）示例代码如下：

示例目录说明如下：

• CMakeLists.txt：示例工程的CMakeList文件。
• demo：示例文件。
• include
• lib：包含curl、jsoncpp动态库。

  根据平台不同，使用如下版本软件加载库文件：

  • linux（Glibc：2.5及以上，Gcc4或Gcc5）
  • windows（VS2013、VS2015）
• readme.txt：说明文件。
• release.log：更新记录。
• version：版本号。
• build.sh：示例编译脚本。

编译运行操作步骤：

假设示例文件已解压至路径下，在Linux终端依次执行如下命令编译运行程序。

• 支持Cmake：
  1. 确认本地系统已安装Cmake 2.4及以上版本。
  2. 。
  3. 。
  4. 。
  5. 。
  6. 。
  7. 。
• 不支持Cmake：
  1. 。
  2. 。
  3. 。
  4. 。
  5. 。
  6. 。

示例代码如下：

版权声明：

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！

转载请注明出处，原文链接：https://www.xkablog.com/rfx/69679.html