Improve parameters

Author: mevdschee

api.php

@@ -3359,6 +3359,7 @@ public function build(): OpenApiDefinition
         foreach ($tableNames as $tableName) {
             $this->setComponentSchema($tableName);
         }
+        $this->setComponentParameters();
         foreach ($tableNames as $index => $tableName) {
             $this->setTag($index, $tableName);
         }
@@ -3378,10 +3379,7 @@ private function setPath(String $tableName) /*: void*/
                     continue;
                 }
                 $path = sprintf('/records/%s/{%s}', $tableName, $pkName);
-                $this->openapi->set("paths|$path|$method|parameters|0|name", "id");
-                $this->openapi->set("paths|$path|$method|parameters|0|in", "path");
-                $this->openapi->set("paths|$path|$method|parameters|0|schema|type", "string");
-                $this->openapi->set("paths|$path|$method|parameters|0|required", true);
+                $this->openapi->set("paths|$path|$method|parameters|0|\$ref", "#/components/parameters/pk");
             }
             $this->openapi->set("paths|$path|$method|tags|0", "$tableName");
             $this->openapi->set("paths|$path|$method|description", "$operation $tableName");
@@ -3403,6 +3401,15 @@ private function setComponentSchema(String $tableName) /*: void*/
         }
     }
 
+    private function setComponentParameters() /*: void*/
+    {
+        $this->openapi->set("components|parameters|pk|name", "id");
+        $this->openapi->set("components|parameters|pk|in", "path");
+        $this->openapi->set("components|parameters|pk|schema|type", "string");
+        $this->openapi->set("components|parameters|pk|description", "primary key value");
+        $this->openapi->set("components|parameters|pk|required", true);
+    }
+
     private function setTag(int $index, String $tableName) /*: void*/
     {
         $this->openapi->set("tags|$index|name", "$tableName");

src/Tqdev/PhpCrudApi/OpenApi/OpenApiBuilder.php

@@ -48,6 +48,7 @@ public function build(): OpenApiDefinition
         foreach ($tableNames as $tableName) {
             $this->setComponentSchema($tableName);
         }
+        $this->setComponentParameters();
         foreach ($tableNames as $index => $tableName) {
             $this->setTag($index, $tableName);
         }
@@ -67,10 +68,7 @@ private function setPath(String $tableName) /*: void*/
                     continue;
                 }
                 $path = sprintf('/records/%s/{%s}', $tableName, $pkName);
-                $this->openapi->set("paths|$path|$method|parameters|0|name", "id");
-                $this->openapi->set("paths|$path|$method|parameters|0|in", "path");
-                $this->openapi->set("paths|$path|$method|parameters|0|schema|type", "string");
-                $this->openapi->set("paths|$path|$method|parameters|0|required", true);
+                $this->openapi->set("paths|$path|$method|parameters|0|\$ref", "#/components/parameters/pk");
             }
             $this->openapi->set("paths|$path|$method|tags|0", "$tableName");
             $this->openapi->set("paths|$path|$method|description", "$operation $tableName");
@@ -92,6 +90,15 @@ private function setComponentSchema(String $tableName) /*: void*/
         }
     }
 
+    private function setComponentParameters() /*: void*/
+    {
+        $this->openapi->set("components|parameters|pk|name", "id");
+        $this->openapi->set("components|parameters|pk|in", "path");
+        $this->openapi->set("components|parameters|pk|schema|type", "string");
+        $this->openapi->set("components|parameters|pk|description", "primary key value");
+        $this->openapi->set("components|parameters|pk|required", true);
+    }
+
     private function setTag(int $index, String $tableName) /*: void*/
     {
         $this->openapi->set("tags|$index|name", "$tableName");