[#2456] OpenAPI: added embed_relationships param definition.

lib/pleroma/web/api_spec/helpers.ex

@@ -47,6 +47,15 @@ defmodule Pleroma.Web.ApiSpec.Helpers do
     ]
   end
 
+  def embed_relationships_param do
+    Operation.parameter(
+      :embed_relationships,
+      :query,
+      :boolean,
+      "Embed relationships into accounts (Pleroma extension)"
+    )
+  end
+
   def empty_object_response do
     Operation.response("Empty object", "application/json", %Schema{type: :object, example: %{}})
   end

lib/pleroma/web/api_spec/operations/account_operation.ex

@@ -156,7 +156,8 @@ defmodule Pleroma.Web.ApiSpec.AccountOperation do
       description:
         "Accounts which follow the given account, if network is not hidden by the account owner.",
       parameters:
-        [%Reference{"$ref": "#/components/parameters/accountIdOrNickname"}] ++ pagination_params(),
+        [%Reference{"$ref": "#/components/parameters/accountIdOrNickname"}] ++
+          pagination_params() ++ [embed_relationships_param()],
       responses: %{
         200 => Operation.response("Accounts", "application/json", array_of_accounts())
       }
@@ -172,7 +173,8 @@ defmodule Pleroma.Web.ApiSpec.AccountOperation do
       description:
         "Accounts which the given account is following, if network is not hidden by the account owner.",
       parameters:
-        [%Reference{"$ref": "#/components/parameters/accountIdOrNickname"}] ++ pagination_params(),
+        [%Reference{"$ref": "#/components/parameters/accountIdOrNickname"}] ++
+          pagination_params() ++ [embed_relationships_param()],
       responses: %{200 => Operation.response("Accounts", "application/json", array_of_accounts())}
     }
   end

lib/pleroma/web/api_spec/operations/search_operation.ex

@@ -24,7 +24,8 @@ defmodule Pleroma.Web.ApiSpec.SearchOperation do
       tags: ["Search"],
       summary: "Search for matching accounts by username or display name",
       operationId: "SearchController.account_search",
-      parameters: [
+      parameters:
+        [
           Operation.parameter(:q, :query, %Schema{type: :string}, "What to search for",
             required: true
           ),
@@ -46,7 +47,7 @@ defmodule Pleroma.Web.ApiSpec.SearchOperation do
             %Schema{allOf: [BooleanLike], default: false},
             "Only include accounts that the user is following"
           )
-      ],
+        ] ++ [embed_relationships_param()],
       responses: %{
         200 =>
           Operation.response(
@@ -65,7 +66,8 @@ defmodule Pleroma.Web.ApiSpec.SearchOperation do
       security: [%{"oAuth" => ["read:search"]}],
       operationId: "SearchController.search",
       deprecated: true,
-      parameters: [
+      parameters:
+        [
           Operation.parameter(
             :account_id,
             :query,
@@ -78,7 +80,9 @@ defmodule Pleroma.Web.ApiSpec.SearchOperation do
             %Schema{type: :string, enum: ["accounts", "hashtags", "statuses"]},
             "Search type"
           ),
-        Operation.parameter(:q, :query, %Schema{type: :string}, "The search query", required: true),
+          Operation.parameter(:q, :query, %Schema{type: :string}, "The search query",
+            required: true
+          ),
           Operation.parameter(
             :resolve,
             :query,
@@ -97,8 +101,7 @@ defmodule Pleroma.Web.ApiSpec.SearchOperation do
             %Schema{type: :integer},
             "Offset"
           )
-        | pagination_params()
-      ],
+        ] ++ pagination_params() ++ [embed_relationships_param()],
       responses: %{
         200 => Operation.response("Results", "application/json", results())
       }