下载通话录音。
调试
您可以在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&OSSAccessKeyId=LTAI****cqw&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&OSSAccessKeyId=LTA*********kr8M9&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. | 内部错误。建议重试,如果多次重试报错请提交工单。 |
访问错误中心查看更多错误码。
文档内容是否对您有帮助?