Introduce the Subscriber API. Closes #787

app/Http/Controllers/Api/SubscriberController.php

@@ -0,0 +1,77 @@
+<?php
+
+/*
+ * This file is part of Cachet.
+ *
+ * (c) Alt Three Services Limited
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace CachetHQ\Cachet\Http\Controllers\Api;
+
+use CachetHQ\Cachet\Events\CustomerHasSubscribedEvent;
+use CachetHQ\Cachet\Models\Subscriber;
+use Exception;
+use GrahamCampbell\Binput\Facades\Binput;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpKernel\Exception\BadRequestHttpException;
+
+class SubscriberController extends AbstractApiController
+{
+    /**
+     * Get all subscribers.
+     *
+     * @param \Symfony\Component\HttpFoundation\Request $request
+     *
+     * @return \Illuminate\Database\Eloquent\Collection
+     */
+    public function getSubscribers(Request $request)
+    {
+        $subscribers = Subscriber::paginate(Binput::get('per_page', 20));
+
+        return $this->paginator($subscribers, $request);
+    }
+
+    /**
+     * Create a new subscriber.
+     *
+     * @return \CachetHQ\Cachet\Models\Subscriber
+     */
+    public function postSubscribers()
+    {
+        $subscriberData = Binput::except('verify');
+
+        try {
+            $subscriber = Subscriber::create($subscriberData);
+        } catch (Exception $e) {
+            throw new BadRequestHttpException();
+        }
+
+        if ($subscriber->isValid()) {
+            // If we're auto-verifying the subscriber, don't bother with this event.
+            if (!(Binput::get('verify'))) {
+                event(new CustomerHasSubscribedEvent($subscriber));
+            }
+
+            return $this->item($subscriber);
+        }
+
+        throw new BadRequestHttpException();
+    }
+
+    /**
+     * Delete a subscriber.
+     *
+     * @param \CachetHQ\Cachet\Models\Subscriber $subscriber
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function deleteSubscriber(Subscriber $subscriber)
+    {
+        $subscriber->delete();
+
+        return $this->noContent();
+    }
+}

app/Http/Routes/ApiRoutes.php

@@ -45,10 +45,13 @@ class ApiRoutes
 
             // Api protected
             $router->group(['middleware' => 'auth.api'], function ($router) {
+                $router->get('subscribers', 'SubscriberController@getSubscribers');
+
                 $router->post('components', 'ComponentController@postComponents');
                 $router->post('incidents', 'IncidentController@postIncidents');
                 $router->post('metrics', 'MetricController@postMetrics');
                 $router->post('metrics/{metric}/points', 'MetricPointController@postMetricPoints');
+                $router->post('subscribers', 'SubscriberController@postSubscribers');
 
                 $router->put('components/{component}', 'ComponentController@putComponent');
                 $router->put('incidents/{incident}', 'IncidentController@putIncident');
@@ -59,6 +62,7 @@ class ApiRoutes
                 $router->delete('incidents/{incident}', 'IncidentController@deleteIncident');
                 $router->delete('metrics/{metric}', 'MetricController@deleteMetric');
                 $router->delete('metrics/{metric}/points/{metric_point}', 'MetricPointController@deleteMetricPoint');
+                $router->delete('subscribers/{subscriber}', 'SubscriberController@deleteSubscriber');
             });
         });
     }