Merge pull request #68 from messagebird/create-verify-email

create verify email

Author: marcel corso gonzalez

examples/verify_create_email.py

@@ -0,0 +1,54 @@
+import sys, os
+sys.path.append(os.path.join(os.path.dirname(__file__), '..'))
+
+import messagebird
+
+# ACCESS_KEY   = ''
+# RECIPIENT = ''
+# ORIGINATOR = ''
+
+try:
+  ACCESS_KEY
+except NameError:
+  print('You need to set an ACCESS_KEY constant in this file')
+  sys.exit(1)
+
+try:
+  RECIPIENT 
+except NameError:
+  print('You need to set a RECIPIENT constant in this file')
+  sys.exit(1)
+
+try:
+  ORIGINATOR
+except NameError:
+  print('You need to set a ORIGINATOR constant in this file')
+  sys.exit(1)
+
+try:
+  # Create a MessageBird client with the specified ACCESS_KEY.
+  client = messagebird.Client(ACCESS_KEY)
+
+  # Create a new Verify.
+  verify = client.verify_create_email(RECIPIENT, ORIGINATOR, {
+      'subject': 'your code'
+      })
+
+  # Print the object information.
+  print('\nThe following information was returned as a Verify object:\n')
+  print('  id                  : %s' % verify.id)
+  print('  href                : %s' % verify.href)
+  print('  recipient           : %s' % verify.recipient)
+  print('  reference           : %s' % verify.reference)
+  print('  messages            : %s' % verify.messages)
+  print('  status              : %s' % verify.status)
+  print('  createdDatetime     : %s' % verify.createdDatetime)
+  print('  validUntilDatetime  : %s\n' % verify.validUntilDatetime)
+
+except messagebird.client.ErrorException as e:
+  print('\nAn error occured while requesting a Verify object:\n')
+
+  for error in e.errors:
+    print('  code        : %d' % error.code)
+    print('  description : %s' % error.description)
+    print('  parameter   : %s\n' % error.parameter)

messagebird/client.py

@@ -284,6 +284,17 @@ def verify_create(self, recipient, params=None):
         params.update({'recipient': recipient})
         return Verify().load(self.request('verify', 'POST', params))
 
+    def verify_create_email(self, recipient, originator, params=None):
+        """Create a new email verification."""
+        if params is None:
+            params = {}
+        params.update({
+            'type' : 'email',
+            'recipient': recipient,
+            'originator': originator
+        })
+        return Verify().load(self.request('verify', 'POST', params))
+
     def verify_verify(self, id, token):
         """Verify the token of a specific verification."""
         return Verify().load(self.request('verify/' + str(id), params={'token': token}))

tests/test_verify.py

@@ -29,6 +29,14 @@ def test_verify_create(self):
 
         http_client.request.assert_called_once_with('verify', 'POST', {'recipient': '31612345678'})
 
+    def test_verify_create_email(self):
+        http_client = Mock()
+        http_client.request.return_value = '{}'
+
+        Client('', http_client).verify_create_email('[email protected]', '[email protected]')
+
+        http_client.request.assert_called_once_with('verify', 'POST', {'recipient': '[email protected]', 'originator': '[email protected]', 'type': 'email'})
+
     def test_verify_verify(self):
         http_client = Mock()
         http_client.request.return_value = '{"id": "verify-id","href": "https://rest.messagebird.com/verify/verify-id","recipient": 31612345678,"reference": "MyReference","messages": {"href": "https://rest.messagebird.com/messages/63b168423592d681641eb07b76226648"},"status": "verified","createdDatetime": "2017-05-30T12:39:50+00:00","validUntilDatetime": "2017-05-30T12:40:20+00:00"}'