Merge pull request #10 from vicent258/clips

Clips

docs/clips.md

@@ -0,0 +1,42 @@
+# Users
+
+Clip objects, top lists.
+
+[Twitch API](https://github.com/justintv/Twitch-API/blob/master/clips.md)
+
+## Functions
+
+`$token` is an optional parameter, but required to be set somewhere.
+
+```php
+<?php
+
+// Clip object
+clip($slug);
+
+// List of clips in a time period, ordered by views
+topClips($options);
+
+
+## Example Usage
+
+File: `App/Https/Controllers/VideosController.php`
+
+```php
+<?php
+
+namespace App\Http\Controllers;
+
+use TwitchApi;
+use App\Http\Controllers\Controller;
+
+class ClipsController extends Controller
+{
+    public function getClip()
+    {
+		// https://clips.twitch.tv/AgreeableOutstandingChickenStinkyCheese
+		$slug = "AgreeableOutstandingChickenStinkyCheese";
+		return TwitchApi::clip($slug);
+    }
+}
+```

src/API/Clips.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace Zarlach\TwitchApi\API;
+
+/**
+ * Twitch documentation: https://github.com/justintv/Twitch-API/blob/master/v3_resources/clips.md.
+ */
+class Clips extends Api
+{
+    /**
+     * Get clip object.
+     *
+     * @param string $slug Clip ID, example: HelloMom
+     *
+     * @return JSON Clip object
+     */
+    public function clip($slug)
+    {
+        return $this->sendRequest('GET', 'clips/'.$slug);
+    }
+
+    /**
+     *  Get top clips by number of views.
+     *
+     * @param array $options Video list options
+     *
+     * @return JSON List of videos
+     */
+    public function clipsTop($options = [])
+    {
+        $availableOptions = ['limit', 'offset', 'game', 'period','limit','trending'];
+
+        return $this->sendRequest('GET', 'clips/top', false, $options, $availableOptions);
+    }
+
+}

src/Services/TwitchApiService.php

@@ -17,6 +17,7 @@
 use Zarlach\TwitchApi\API\Teams;
 use Zarlach\TwitchApi\API\Users;
 use Zarlach\TwitchApi\API\Videos;
+use Zarlach\TwitchApi\API\Clips;
 
 class TwitchApiService extends Api
 {
@@ -357,4 +358,22 @@ public function channelVideos($channel, $options = [])
 
         return $videos->channelVideos($channel, $options);
     }
+    /**
+     * Clips.
+     */
+    public function clip($slug)
+    {
+        $clips = new Clips();
+
+        return $clips->clip($slug);
+    }
+
+    public function topClips($options = [])
+    {
+        $clips = new Clips();
+
+        return $clips->clipsTop($options);
+    }
+
+
 }