Added support for Contacts and Groups

.travis.yml

@@ -1,4 +1,5 @@
 language: php
+dist: precise
 php:
     - 5.3
     - 5.4
@@ -13,6 +14,7 @@ matrix:
     allow_failures:
         - php: 7.0
         - php: 7.1
+        - php: hhvm
         - php: hhvm-nightly
 
 script: phpunit --verbose

examples/contact-create.php

@@ -0,0 +1,27 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+$Contact             = new \MessageBird\Objects\Contact();
+$Contact->msisdn = "31123456780";
+$Contact->firstName = "FirstName";
+$Contact->lastName = "LastName";
+$Contact->custom1 = "test_custom1";
+$Contact->custom2 = "test_custom2";
+$Contact->custom3 = "test_custom3";
+$Contact->custom4 = "test_custom4";
+
+
+try {
+    $ContactResult = $MessageBird->contacts->create($Contact);
+    var_dump($ContactResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/contact-delete.php

@@ -0,0 +1,18 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $deleted = $MessageBird->contacts->delete('123_contact_id'); // Set a contact id here
+    var_dump('Deleted: ' . $deleted);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+
+}

examples/contact-get-groups.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $ContactGroupsList = $MessageBird->contacts->getGroups('contact_id');
+    var_dump($ContactGroupsList);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/contact-get-messages.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $ContactMessageList = $MessageBird->contacts->getMessages('contact_id');
+    var_dump($ContactMessageList);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/contact-list.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $ContactList = $MessageBird->contacts->getList(array ());
+    var_dump($ContactList);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/contact-update.php

@@ -0,0 +1,27 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+$Contact = new \MessageBird\Objects\Contact();
+$Contact->msisdn = '31123456789';
+$Contact->firstName = 'ChangedFirst';
+$Contact->lastName = "ChangedLast";
+$Contact->custom1 = "custom-1b";
+$Contact->custom2 = "custom-2b";
+$Contact->custom3 = "custom-3b";
+$Contact->custom4 = "custom-4b";
+
+
+try {
+    $GroupResult = $MessageBird->contacts->update($Contact, 'contact_id');
+    var_dump($GroupResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/contact-view.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $ContactResult = $MessageBird->contacts->read('123_contact_id'); // Set a contact id here
+    var_dump($ContactResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/group-add-contact-to-group.php

@@ -0,0 +1,22 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $contacts['ids'] = array(
+        'contact_id_1',
+        'contact_id_2',
+    );
+    $group_id = 'group_id';
+    $GroupAddContact = $MessageBird->groups->addContacts($contacts, $group_id);
+    var_dump($GroupAddContact);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/group-create.php

@@ -0,0 +1,20 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+$Group             = new \MessageBird\Objects\Group();
+$Group->name       = "group_name";
+
+try {
+    $GroupResult = $MessageBird->groups->create($Group);
+    var_dump($GroupResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/group-delete.php

@@ -0,0 +1,18 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $deleted = $MessageBird->groups->delete('group_id'); // Set a group id here
+    var_dump('Deleted: ' . $deleted);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+
+}

examples/group-get-contacts.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $GroupsContactList = $MessageBird->groups->getContacts('group_id');
+    var_dump($GroupsContactList);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/group-list.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $GroupsList = $MessageBird->groups->getList(array ());
+    var_dump($GroupsList);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/group-remove-contact-from-group.php

@@ -0,0 +1,19 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $contact_id = 'contact_id';
+    $group_id = 'group_id';
+    $GroupAddContact = $MessageBird->groups->removeContact($contact_id, $group_id);
+    var_dump($GroupAddContact);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

examples/group-update.php

@@ -0,0 +1,20 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+$Group = new \MessageBird\Objects\Group();
+$Group->name = 'New group name';
+
+try {
+    $GroupResult = $MessageBird->groups->update($Group, 'group_id');
+    var_dump($GroupResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    echo $e->getMessage();
+}

examples/group-view.php

@@ -0,0 +1,17 @@
+<?php
+
+require_once(__DIR__ . '/../autoload.php');
+
+$MessageBird = new \MessageBird\Client('YOUR_ACCESS_KEY'); // Set your own API access key here.
+
+try {
+    $GroupResult = $MessageBird->groups->read('group_id'); // Set a group id here
+    var_dump($GroupResult);
+
+} catch (\MessageBird\Exceptions\AuthenticateException $e) {
+    // That means that your accessKey is unknown
+    echo 'Wrong login';
+
+} catch (\Exception $e) {
+    var_dump($e->getMessage());
+}

src/MessageBird/Client.php

@@ -12,7 +12,7 @@ class Client
     const ENDPOINT = 'https://rest.messagebird.com';
     const CHATAPI_ENDPOINT = 'https://chat.messagebird.com/1';
 
-    const CLIENT_VERSION = '1.6.6';
+    const CLIENT_VERSION = '1.7.0';
 
     /**
      * @var string
@@ -24,6 +24,16 @@ class Client
      */
     public $messages;
 
+    /**
+     * @var Resources\Contacts
+     */
+    public $contacts;
+
+    /**
+     * @var Resources\Groups
+     */
+    public $groups;
+
     /**
      * @var Resources\VoiceMessage
      */
@@ -115,6 +125,8 @@ public function __construct($accessKey = null, Common\HttpClient $httpClient = n
         $this->voicemessages = new Resources\VoiceMessage($this->HttpClient);
         $this->lookup        = new Resources\Lookup($this->HttpClient);
         $this->lookupHlr     = new Resources\LookupHlr($this->HttpClient);
+        $this->contacts      = new Resources\Contacts($this->HttpClient);
+        $this->groups        = new Resources\Groups($this->HttpClient);
         $this->chatMessages  = new Resources\Chat\Message($this->ChatAPIHttpClient);
         $this->chatChannels  = new Resources\Chat\Channel($this->ChatAPIHttpClient);
         $this->chatPlatforms = new Resources\Chat\Platform($this->ChatAPIHttpClient);

src/MessageBird/Common/HttpClient.php

@@ -16,6 +16,7 @@ class HttpClient
     const REQUEST_POST = 'POST';
     const REQUEST_DELETE = 'DELETE';
     const REQUEST_PUT = 'PUT';
+    const REQUEST_PATCH = "PATCH";
 
     const HTTP_NO_CONTENT = 204;
 
@@ -153,6 +154,9 @@ public function performHttpRequest($method, $resourceName, $query = null, $body
         } elseif ($method === self::REQUEST_PUT){
             curl_setopt($curl, CURLOPT_CUSTOMREQUEST, self::REQUEST_PUT);
             curl_setopt($curl, CURLOPT_POSTFIELDS, $body);
+        } elseif ($method === self::REQUEST_PATCH){
+            curl_setopt($curl, CURLOPT_CUSTOMREQUEST, self::REQUEST_PATCH);
+            curl_setopt($curl, CURLOPT_POSTFIELDS, $body);
         }
 
         // Some servers have outdated or incorrect certificates, Use the included CA-bundle