From 7648ff2a8c94f8a3b3f14c846f6b2b9f88e842ce Mon Sep 17 00:00:00 2001
From: Olivier Langlois <olivier@trillion01.com>
Date: Fri, 22 Apr 2016 10:59:08 -0400
Subject: [PATCH] Add low-level function to API for fast subscribe

This allows to reduce the number of HTTP requests required to add subscriber
from 4 to 1.

Example of usage is:

application = new AWeberAPI($consumerKey, $consumerSecret);
$application->setUser($accessToken, $accessSecret);
$subscribersUrl = "/accounts/$accountid/lists/$listid/subscribers";
application->createToUrl($subscribersUrl, $subscriber);
---
 aweber_api/aweber.php | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/aweber_api/aweber.php b/aweber_api/aweber.php
index 49f0611..f6b9ee2 100644
--- a/aweber_api/aweber.php
+++ b/aweber_api/aweber.php
@@ -105,6 +105,28 @@ public function loadFromUrl($url) {
         return $this->readResponse($data, $url);
     }
 
+    /**
+     * createToUrl
+     *
+     * Invoke the API method to CREATE a new entry resource.
+     * without creating an object.
+     *
+     * Note: Not all entry resources are eligible to be created, please
+     *       refer to the AWeber API Reference Documentation at
+     *       https://labs.aweber.com/docs/reference/1.0 for more
+     *       details on which entry resources may be created and what
+     *       attributes are required for creating resources.
+     *
+     * @param mixed $url    URL for this request
+     * @param params mixed  associtative array of key/value pairs.
+     * @access public
+     * @return mixed reply header
+     */
+    public function createToUrl($url, $kv_pairs) {
+        $params = array_merge(array('ws.op' => 'create'), $kv_pairs);
+        return $this->adapter->request('POST', $url, $params, array('return' => 'headers'));
+    }
+
     protected function _cleanUrl($url) {
         return str_replace($this->adapter->app->getBaseUri(), '', $url);
     }
@@ -228,6 +250,13 @@ public function setAdapter($adapter=null) {
         $this->adapter = $adapter;
     }
 
+    public function setUser($token, $secret) {
+        $user = new OAuthUser();
+        $user->accessToken = $token;
+        $user->tokenSecret = $secret;
+        $this->adapter->user = $user;
+    }
+
     /**
      * Fetches account data for the associated account
      *
@@ -240,10 +269,7 @@ public function setAdapter($adapter=null) {
      */
     public function getAccount($token=false, $secret=false) {
         if ($token && $secret) {
-            $user = new OAuthUser();
-            $user->accessToken = $token;
-            $user->tokenSecret = $secret;
-            $this->adapter->user = $user;
+            $this->setUser($token,$secret);
         }
 
         $body = $this->adapter->request('GET', '/accounts');