fix api

Author: vanderkorn

.idea/workspace.xml

@@ -255,11 +255,13 @@ private function processLaravelRoutes(AbstractGenerator $generator, $allowedRout
         $routes = $this->getRoutes();
         $bindings = $this->getBindings();
         $parsedRoutes = [];
+        $i =1;
         foreach ($routes as $route) {
             if (in_array($route->getName(), $allowedRoutes) || str_is($routePrefix, $route->getUri()) || in_array($middleware, $route->middleware())) {
                 if ($this->isValidRoute($route) && $this->isRouteVisibleForDocumentation($route->getAction()['uses'])) {
-                    $parsedRoutes[] = $generator->processRoute($route, $bindings, $this->option('header'), $withResponse);
+                    $parsedRoutes[] = $generator->processRoute($i, $route, $bindings, $this->option('header'), $withResponse);
                     $this->info('Processed route: ['.implode(',', $route->getMethods()).'] '.$route->getUri());
+                    $i++;
                 } else {
                     $this->warn('Skipping route: ['.implode(',', $route->getMethods()).'] '.$route->getUri());
                 }
@@ -285,7 +287,7 @@ private function processDingoRoutes(AbstractGenerator $generator, $allowedRoutes
         foreach ($routes as $route) {
             if (empty($allowedRoutes) || in_array($route->getName(), $allowedRoutes) || str_is($routePrefix, $route->uri()) || in_array($middleware, $route->middleware())) {
                 if ($this->isValidRoute($route) && $this->isRouteVisibleForDocumentation($route->getAction()['uses'])) {
-                    $parsedRoutes[] = $generator->processRoute($route, $bindings, $this->option('header'), $withResponse);
+                    $parsedRoutes[] = $generator->processRoute(0, $route, $bindings, $this->option('header'), $withResponse);
                     $this->info('Processed route: ['.implode(',', $route->getMethods()).'] '.$route->uri());
                 } else {
                     $this->warn('Skipping route: ['.implode(',', $route->getMethods()).'] '.$route->uri());

src/Mpociot/ApiDoc/Commands/GenerateDocumentation.php

@@ -27,7 +27,7 @@ abstract protected function getUri($route);
      *
      * @return array
      */
-    abstract public function processRoute($route, $bindings = [], $withResponse = true);
+    abstract public function processRoute($i, $route, $bindings = [], $withResponse = true);
 
     /**
      * Prepares / Disables route middlewares.

src/Mpociot/ApiDoc/Generators/AbstractGenerator.php

@@ -14,7 +14,7 @@ class DingoGenerator extends AbstractGenerator
      *
      * @return array
      */
-    public function processRoute($route, $bindings = [], $headers = [], $withResponse = true)
+    public function processRoute($i, $route, $bindings = [], $headers = [], $withResponse = true)
     {
         $response = '';
 

src/Mpociot/ApiDoc/Generators/DingoGenerator.php

@@ -28,7 +28,7 @@ protected function getUri($route)
      *
      * @return array
      */
-    public function processRoute($route, $bindings = [], $headers = [], $withResponse = true)
+    public function processRoute($i, $route, $bindings = [], $headers = [], $withResponse = true)
     {
         $content = '';
 
@@ -48,7 +48,7 @@ public function processRoute($route, $bindings = [], $headers = [], $withRespons
         return $this->getParameters([
             'id' => md5($route->getUri().':'.implode($route->getMethods())),
             'resource' => $routeGroup,
-            'title' => $routeDescription['short'],
+            'title' => $i. " - " . $routeDescription['short'],
             'description' => $routeDescription['long'],
             'methods' => $route->getMethods(),
             'uri' => $route->getUri(),

src/Mpociot/ApiDoc/Generators/LaravelGenerator.php

@@ -1,28 +1,26 @@
 <!-- START_{{$parsedRoute['id']}} -->
-@if($parsedRoute['title'] != '')## {{ $parsedRoute['title']}}
+@if($parsedRoute['title'] != '')## {{$parsedRoute['title']}}
 @else## {{$parsedRoute['uri']}}
 @endif
-@if($parsedRoute['description'])
 
-{!! $parsedRoute['description'] !!}
+@if($parsedRoute['description'])
+    {!! $parsedRoute['description'] !!}
 @endif
 
-
 ### HTTP Request
 
 @foreach($parsedRoute['methods'] as $method)
-`{{$method}} {{$parsedRoute['uri']}}`
+    @if($method!="HEAD")`{{$method}} {{$parsedRoute['uri']}}`@endif
 @endforeach
 
 @if(count($parsedRoute['parameters']))
-#### Parameters
+### Parameters
 
 Parameter | Type | Status | Description
 --------- | ------- | ------- | ------- | -----------
 @foreach($parsedRoute['parameters'] as $attribute => $parameter)
     {{$attribute}} | {{$parameter['type']}} | @if($parameter['required']) required @else optional @endif | {!! implode(' ',$parameter['description']) !!}
 @endforeach
-
 @endif
 
 <!-- END_{{$parsedRoute['id']}} -->