- Update docs

- Register ModelNotFoundException error handler for Dingo
- Allow the user to update password

Author: joselfonseca

app/Providers/AppServiceProvider.php

@@ -5,6 +5,7 @@
 use App\Services\Users\UsersService;
 use Illuminate\Support\ServiceProvider;
 use App\Contracts\Users\UsersServiceContract;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
 
 class AppServiceProvider extends ServiceProvider
 {
@@ -26,5 +27,8 @@ public function boot()
     public function register()
     {
         $this->app->bind(UsersServiceContract::class, UsersService::class);
+        app('Dingo\Api\Exception\Handler')->register(function (ModelNotFoundException $exception) {
+            throw new \Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+        });
     }
 }

app/Services/Users/UsersService.php

@@ -125,8 +125,8 @@ public function update($id, array $attributes = [])
         if (isset($attributes['email']) && $attributes['email'] != $model->email) {
             $this->validationUpdateRules['email'] = 'sometimes|required|unique:users,email,'.$model->id;
         }
-        if (isset($attributes['password'])) {
-            unset($attributes['password']);
+        if(isset($attributes['password'])) {
+            $attributes['password'] = bcrypt($attributes['password']);
         }
         $this->runValidator($attributes, $this->validationUpdateRules, $this->validationMessages);
         $model->fill($attributes);

composer.json

@@ -22,7 +22,7 @@
         "laravel/passport": "^2.0",
         "webpatser/laravel-uuid": "^2.0",
         "spatie/laravel-permission": "^1.7",
-        "joselfonseca/laravel-api-tools" : "3.0.*"
+        "joselfonseca/laravel-api-tools" : "dev-master"
     },
     "require-dev": {
         "fzaninotto/faker": "~1.4",

composer.lock

@@ -1,5 +1,5 @@
 FORMAT: 1A
-HOST: https://example.com/api
+HOST: https://example.com
 
 # Laravel API
 Welcome to the Starter Kit API, here you will find all the information related to the endpoints available.
@@ -41,6 +41,10 @@ This endpoint will allow you to get the users registered in the system
             + (User Object)
         + meta
             + pagination (User Pagination)
+        + links
+            + self: `http://laravelapi.dev/api/users?page=1` (string)
+            + first: `http://laravelapi.dev/api/users?page=1` (string)
+            + last: `http://laravelapi.dev/api/users?page=1` (string)
 
 + Response 401 (application/json)
 
@@ -188,36 +192,38 @@ This endpoint will allow you to delete a user from the system
 # Data Structures
 
 ## Error 404 (object)
-- code: 404 (number)
-- title: `Not found` (string)
+- status_code: 404 (number)
+- message: `Not found` (string)
 
 ## Error 400 (object)
-- code: 400 (number)
-- title: `Bad Request` (string)
+- status_code: 400 (number)
+- message: `Bad Request` (string)
 
 ## Error 403 (object)
-- code: 403 (number)
-- title: `Forbidden` (string)
+- status_code: 403 (number)
+- message: `Forbidden` (string)
 
 ## Error 401 (object)
-- code: 401 (number)
-- title: `Unauthorized` (string)
+- status_code: 401 (number)
+- message: `Unauthorized` (string)
 
 ## Error 405 (object)
-- code: 405 (number)
-- title: `Method Not Allowed` (string)
+- status_code: 405 (number)
+- message: `Method Not Allowed` (string)
 
 ## Error 422 (object)
-- code: 422 (number)
-- title: `Validation error` (string)
+- status_code: 422 (number)
+- message: `Validation error` (string)
 - errors (array) `Array of errors present in the validation`
 
 ## User Object (object)
+- type: `user` (string)
 - id: `d4d42ea0-ee77-11e6-b823-6d63c6504afc` (string)
-- name: `Jhon Doe` (string)
-- email: `[email protected]` (string)
-- created_at: `2017-02-09T03:28:32+00:00` (string)
-- updated_at: `2017-02-09T03:28:32+00:00` (string)
+- attributes
+    - name: `Jhon Doe` (string)
+    - email: `[email protected]` (string)
+    - created_at: `2017-02-09T03:28:32+00:00` (string)
+    - updated_at: `2017-02-09T03:28:32+00:00` (string)
 
 ## User Create (object)
 - name: `Jhon Doe` (string, required)

docs/api/blueprint/apidocs.apib

@@ -5,7 +5,8 @@
     "watch": "cross-env NODE_ENV=development node_modules/webpack/bin/webpack.js --watch --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js",
     "watch-poll": "cross-env NODE_ENV=development node_modules/webpack/bin/webpack.js --watch --watch-poll --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js",
     "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",
-    "production": "cross-env NODE_ENV=production node_modules/webpack/bin/webpack.js --progress --hide-modules --config=node_modules/laravel-mix/setup/webpack.config.js"
+    "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 --theme-template triple -o resources/views/apidocs.blade.php"
   },
   "devDependencies": {
     "axios": "^0.15.3",