Downloading CDRs and Recording Indexes
Description
This interface is invoked to download the .zip file (yyyymmdd_ responseId) of the CDR or recording package. You can view the CDR description (yyyyMMddHHmmssSSS+Three-digit random number_call.csv) and the detailed indexes (yyyyMMddHHmmssSSS+Three-digit random number_record.csv) generated for each recording.
Usage Description
- Prerequisites
- CDRs and recording index files have been generated at the backend by invoking the interface for generating CDRs and recording indexes.
- You have passed the authorization and obtained the access URL.
- Usage restrictions
Developers can only download files under their own accounts. The developer account (appId) must correspond to the data record file name (billFileName).
The developer account (appId) is contained in the authentication string. For details, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.
Interface Method
POST
URI
https://ip:port/CCFS/resource/ccfs/downloadBillFile
Set ip to the IP address of the server where the CC-FS is installed and port to the HTTPS port number of the CC-FS.
If the request is routed through the NSLB, set ip to the IP address of the NSLB server and port to the HTTPS port number of the CC-FS service mapped on the NSLB.
Request
No. |
Name |
Value Type |
Mandatory |
Default Value |
Description |
---|---|---|---|---|---|
1 |
Content-Type |
String |
Yes |
None |
The value is fixed to application/json; charset=UTF-8. |
2 |
Authorization |
String |
Yes |
None |
For details about the generation mode, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication. |
No. |
Name |
Value Type |
Mandatory |
Default Value |
Description |
---|---|---|---|---|---|
1 |
version |
String (1–32) |
Yes |
2.0 |
Protocol version. Currently, the value is fixed to 2.0. |
No. |
Name |
Value Type |
Mandatory |
Default Value |
Description |
---|---|---|---|---|---|
1 |
billFileName |
String (1–49) |
Yes |
None |
Name of a CDR and recording index file, which has been obtained by invoking the interface for generating CDRs and recording indexes. The value is in yyyyMMdd_{responseId}.zip format. For example, if the interface for generating CDRs and recording indexes has been invoked on 2018-07-02, and if the obtained recording index responseId is 9239cb50a8384bb0ab503441bf08944, the value of this parameter is 20180702_9239cb50a8384bb0ab503441bf089446.zip. |
Response
If the interface is successfully invoked, the system obtains the binary data of the file from the HTTP response message to generate a CDR file. The file name extension is .zip. For details about the parameters in the file, see Definitions of CDR and Recording Index Files. In the response message, the value of content-type is Application/Octet-stream;charset=UTF-8.
If the interface fails to be invoked, an error code is returned. For details about the error code data structure, see Table 4. resultData is a reserved field and is left empty by default.
No. |
Name |
Value Type |
Description |
---|---|---|---|
1 |
resultCode |
String |
Result code returned. For details, see Error Code Reference. |
2 |
resultDesc |
String |
Request result description. |
3 |
resultData |
Object |
Response data. |
4 |
response |
Object |
Request result object. For details, see Table 5. This field is reserved for compatibility with earlier versions and is not recommended. |
Example
- Request header
POST /CCFS/resource/ccfs/downloadBillFile HTTP/1.1 Authorization: auth-v2/ak/2018-07-02T02:43:08Z/content-length;content-type;host /ae066c2f5d******************13a0afc161cb7e66f5d Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193
- Request parameters
{ "request": { "version": "2.0" }, "msgBody": { "billFileName": "20180702_9239cb50a8384bb0ab503441bf089446.zip" } }
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot