Deleting an Uploaded File as a Third Party
Description
This API is invoked by a third party to delete an uploaded file. The third-party system is connected to the IVR system by loading a customized JAR package.
Usage Description
- Prerequisites
- You have passed the authorization.
- Usage restrictions
Developers can delete only files under their own accounts. For details, see C2 Monitoring, System Outbound Call, CDR, and Knowledge Base Interface Authentication.
Interface Method
POST
URI
https://ip:port/CCFS/resource/ccfs/ivr/deleteFile
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 |
fileName |
String |
Yes |
None |
File to be deleted. The file path is specified by the system parameter Third-Party Upload File Path Rule. Contact the system administrator to obtain the value of the system parameter in . The default value is /3rdfile/%VDNNO%/thirdvoicebotfile/.Example: {Drive letter}:/3rdfile/{VDN ID}/thirdvoicebotfile/xxx.wav |
2 |
locationId |
String |
No |
None |
This parameter is valid only in CTI pool mode. If locationId has a value, delete the files in the path specified by uapId corresponding to locationId. If locationId is empty, delete all files. |
Response
If this interface is successfully invoked, 0 and the message "operate success" are returned.
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. |
Example
- Request header
POST /CCFS/resource/ccfs/ivr/deleteFile HTTP/1.1 Authorization: auth-v2/ak/2021-08-31T09:38:50.872Z/content-length;content-type;host/c12f0ed0******************941bdd106 Accept: */* Content-Type: application/json;charset=UTF-8 Content-Length: 193
- Request parameters
{ "request": { "version": "2.0" }, "msgBody": { "fileName": "Y:/3rdfile/2/thirdvoicebotfile/5dckNDei_1647502396161.wav" } }
- Response parameters
{ "resultData": null, "resultCode": "0", "resultDesc": "success" }
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