Use render method instead and update docs for render image endpoint

Author: joselfonseca

app/Transformers/Assets/AssetTransformer.php

@@ -22,8 +22,8 @@ public function transform(Asset $model)
             'path' => $model->path,
             'mime' => $model->mime,
             'links' => [
-                'full' => url('api/assets/'.$model->uuid),
-                'thumb' => url('api/assets/'.$model->uuid.'?width=200&height=200'),
+                'full' => url('api/assets/'.$model->uuid.'/render'),
+                'thumb' => url('api/assets/'.$model->uuid.'/render?width=200&height=200'),
             ],
             'created_at' => $model->created_at->toIso8601String(),
         ];

docs/api/blueprint/dataStructures/assets.apib

@@ -4,7 +4,7 @@
 + type: `image` (string) - The asset type
 + path: `12342bh3y3bn3i4i5ii5b43o3n.jpg` (string) - The asset path in the storage
 + links
-    + full: `https://laravelapi.test/api/assets/0c244c51-0a3b-4b86-829a-ee161c2f966f` (string) - The asset link for render full size
-    + thumb: `https://laravelapi.test/api/assets/0c244c51-0a3b-4b86-829a-ee161c2f966f?width=200&height=200` (string) - The asset link for render thumb size
+    + full: `https://laravelapi.test/api/assets/0c244c51-0a3b-4b86-829a-ee161c2f966f/render` (string) - The asset link for render full size
+    + thumb: `https://laravelapi.test/api/assets/0c244c51-0a3b-4b86-829a-ee161c2f966f/render?width=200&height=200` (string) - The asset link for render thumb size
 + created_at : `1997-07-16T19:20:30+01:00` (string) - Date in format iso 8601
 

package.json

@@ -8,7 +8,7 @@
     "hot": "cross-env NODE_ENV=development node_modules/webpack-dev-server/bin/webpack-dev-server.js --inline --hot --config=node_modules/laravel-mix/setup/webpack.config.js",
     "prod": "npm run production",
     "production": "cross-env NODE_ENV=production node_modules/webpack/bin/webpack.js --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js",
-    "docs": "aglio -i docs/api/blueprint/apidocs.apib --theme-variables Flatly -o resources/views/apidocs.blade.php"
+    "docs": "aglio -i docs/api/blueprint/apidocs.apib --theme-variables Flatly --theme-template triple -o resources/views/apidocs.blade.php"
   },
   "devDependencies": {
     "axios": "^0.15.3",

resources/views/apidocs.blade.php

@@ -8,7 +8,7 @@
 
         $api->get('ping', 'Api\PingController@index');
 
-        $api->get('assets/{uuid}/{width?}/{height?}', 'Api\Assets\RenderFileController@show');
+        $api->get('assets/{uuid}/render', 'Api\Assets\RenderFileController@show');
 
         $api->group(['middleware' => ['auth:api'], ], function ($api) {