Merge pull request #103 from messagebird/deleteVoiceRecording

delete voice recording

Author: denizkilic

api/src/main/java/com/messagebird/MessageBirdClient.java

@@ -1345,6 +1345,38 @@ public RecordingResponse listRecordings(String callID, String legId, final Integ
         return messageBirdService.requestList(url, offset, limit, RecordingResponse.class);
     }
 
+    /**
+     * Deletes a voice recording
+     *
+     * @param callID Voice call ID
+     * @param legID Leg ID
+     * @param recordingID Recording ID
+     * @throws UnauthorizedException if client is unauthorized
+     * @throws GeneralException      general exception
+     */
+    public void deleteRecording(final String callID, final String legID, final String recordingID)
+            throws NotFoundException, GeneralException, UnauthorizedException {
+        if (callID == null) {
+            throw new IllegalArgumentException("Call ID must be specified.");
+        }
+        if (legID == null) {
+            throw new IllegalArgumentException("Leg ID must be specified.");
+        }
+        if (recordingID == null) {
+            throw new IllegalArgumentException("Recording ID must be specified.");
+        }
+        String url = String.format(
+                "%s%s/%s%s/%s%s",
+                VOICE_CALLS_BASE_URL,
+                VOICECALLSPATH,
+                callID,
+                LEGSPATH,
+                legID,
+                RECORDINGPATH
+        );
+        messageBirdService.deleteByID(url, recordingID);
+    }
+
     /**
      * Function to view recording by call id , leg id and recording id
      *

api/src/test/java/com/messagebird/MessageBirdClientTest.java

@@ -938,4 +938,20 @@ public void deletePurchasedNumber()  throws UnauthorizedException, GeneralExcept
         verify(messageBirdServiceMock, times(1)).deleteByID(url, phoneNumber);
     }
 
+    @Test
+    public void testDeleteRecording() throws NotFoundException, GeneralException, UnauthorizedException {
+        MessageBirdService messageBirdServiceMock = mock(MessageBirdService.class);
+        MessageBirdClient messageBirdClientMock = new MessageBirdClient(messageBirdServiceMock);
+        String url = String.format(
+                "%s%s/%s%s/%s%s",
+                VOICE_CALLS_BASE_URL,
+                VOICECALLSPATH,
+                "ANY_CALL_ID",
+                LEGSPATH,
+                "ANY_LEG_ID",
+                RECORDINGPATH
+        );
+        messageBirdClientMock.deleteRecording("ANY_CALL_ID", "ANY_LEG_ID","recordingID");
+        verify(messageBirdServiceMock, times(1)).deleteByID(url , "recordingID");
+    }
 }

examples/src/main/java/ExampleDeleteRecording.java

@@ -0,0 +1,35 @@
+import com.messagebird.MessageBirdClient;
+import com.messagebird.MessageBirdService;
+import com.messagebird.MessageBirdServiceImpl;
+import com.messagebird.exceptions.GeneralException;
+import com.messagebird.exceptions.NotFoundException;
+import com.messagebird.exceptions.UnauthorizedException;
+
+public class ExampleDeleteRecording {
+    public static void main(String[] args) {
+
+        if (args.length < 3) {
+            System.out.println("Please specify your access key and a call_id, leg_id, and recording_id to delete: java -jar <this jar file> <test_accesskey> <call_id> <leg_id> <recording_id>" );
+            return;
+        }
+
+        // First create your service object
+        final MessageBirdService wsr = new MessageBirdServiceImpl(args[0]);
+
+        // Add the service to the client
+        final MessageBirdClient messageBirdClient = new MessageBirdClient(wsr);
+
+        try {
+            // Deleting message by id
+            System.out.println("Delete recording:");
+            messageBirdClient.deleteRecording(args[1],args[2],args[3]);
+            System.out.println("Recording ID ["+args[3]+"] deleted.");
+
+        } catch (UnauthorizedException | GeneralException | NotFoundException exception) {
+            if (exception.getErrors() != null) {
+                System.out.println(exception.getErrors().toString());
+            }
+            exception.printStackTrace();
+        }
+    }
+}

examples/src/main/java/ExampleSendVoiceCall.java

@@ -31,6 +31,7 @@ public static void main(String[] args) {
             final VoiceCall voiceCall = new VoiceCall();
             voiceCall.setSource("31644556677");
             voiceCall.setDestination(args[1]);
+            voiceCall.setWebhook("https://example.com/","foobar");
 
             //Title and steps are required fields for creating callFlow
             final VoiceCallFlow voiceCallFlow = new VoiceCallFlow();