下载通话录音

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DownloadRecording

系统规定参数。取值：DownloadRecording。
InstanceId String 是 da37319b-6c83-4268-9f19-814aed62e401

实例id
TaskId String 是 744b27f3-437f-4a8c-a181-f668e492fd24

任务id，通话来自这个任务
NeedVoiceSliceRecording Boolean 否 false

是否查询分段录音

返回数据

名称 类型 示例值 描述
HttpStatusCode Integer 200

Http状态码
Code String OK

接口状态码
Message String Success

接口提示消息
RequestId String 254EB995-DEDF-48A4-9101-9CA5B72FFBCC

请求id
Success Boolean true

是否成功
DownloadParams Object

文档下载地址
SignatureUrl String http://tiangong-staging.oss-cn-shanghai.aliyuncs.com/record/281eb174-3865-41c1-9274-7b6813edadab.wav?Expires=1578624046&OSSAccessKeyId=LTAI****cqw&Signature=dL2dxWS6VcdZrvG9xOMOBMSP3Fg%3D

一个指向录音文件的url，使用http下载
FileName String 281eb174-3865-41c1-9274-7b6813edadab.wav

录音文件名，通常为一个uuid
VoiceSliceRecordingListJson String [{"fileName":"10a17c447415424c99491884abe27d8a-1.wav","filePath":"https://ssml-test.oss-cn-shanghai.aliyuncs.com/7253/voiceSlice/10a17c447415424c99491884abe27d8a/10a17c447415424c99491884abe27d8a-1.wav?Expires=1686645470&OSSAccessKeyId=LTA*********kr8M9&Signature=V23OhiV5yIOoouriu6SiWkO9h8E%3D"}]

分段录音列表，包含文件名和文件url

示例

请求示例

http(s)://[Endpoint]/?Action=DownloadRecording
&InstanceId=da37319b-6c83-4268-9f19-814aed62e401
&TaskId=744b27f3-437f-4a8c-a181-f668e492fd24
&NeedVoiceSliceRecording=false
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DownloadRecordingResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <Code>OK</Code>
    <Message>Success</Message>
    <RequestId>254EB995-DEDF-48A4-9101-9CA5B72FFBCC</RequestId>
    <Success>true</Success>
    <DownloadParams>
        <SignatureUrl>http://tiangong-staging.oss-cn-shanghai.aliyuncs.com/record/281eb174-3865-41c1-9274-7b6813edadab.wav?Expires=1578624046&amp;OSSAccessKeyId=LTAI****cqw&amp;Signature=dL2dxWS6VcdZrvG9xOMOBMSP3Fg%3D</SignatureUrl>
        <FileName>281eb174-3865-41c1-9274-7b6813edadab.wav</FileName>
        <VoiceSliceRecordingListJson>[{"fileName":"10a17c447415424c99491884abe27d8a-1.wav","filePath":"https://ssml-test.oss-cn-shanghai.aliyuncs.com/7253/voiceSlice/10a17c447415424c99491884abe27d8a/10a17c447415424c99491884abe27d8a-1.wav?Expires=1686645470&amp;OSSAccessKeyId=LTA*********kr8M9&amp;Signature=V23OhiV5yIOoouriu6SiWkO9h8E%3D"}]</VoiceSliceRecordingListJson>
    </DownloadParams>
</DownloadRecordingResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "HttpStatusCode" : 200,
  "Code" : "OK",
  "Message" : "Success",
  "RequestId" : "254EB995-DEDF-48A4-9101-9CA5B72FFBCC",
  "Success" : true,
  "DownloadParams" : {
    "SignatureUrl" : "http://tiangong-staging.oss-cn-shanghai.aliyuncs.com/record/281eb174-3865-41c1-9274-7b6813edadab.wav?Expires=1578624046&OSSAccessKeyId=LTAI****cqw&Signature=dL2dxWS6VcdZrvG9xOMOBMSP3Fg%3D",
    "FileName" : "281eb174-3865-41c1-9274-7b6813edadab.wav",
    "VoiceSliceRecordingListJson" : "[{\"fileName\":\"10a17c447415424c99491884abe27d8a-1.wav\",\"filePath\":\"https://ssml-test.oss-cn-shanghai.aliyuncs.com/7253/voiceSlice/10a17c447415424c99491884abe27d8a/10a17c447415424c99491884abe27d8a-1.wav?Expires=1686645470&OSSAccessKeyId=LTA*********kr8M9&Signature=V23OhiV5yIOoouriu6SiWkO9h8E%3D\"}]"
  }
}

错误码

HttpCode 错误码 错误信息 描述
404 NotExist.Instance The specified Instance does not exist. 指定的实例不存在。
500 InternalError An error occurred while processing your request. Please try again later. Submit a ticket if the error still exists. 内部错误。建议重试，如果多次重试报错请提交工单。

访问错误中心查看更多错误码。