[#2456] OpenAPI: added embed_relationships param definition.

This commit is contained in:
Ivan Tashkinov 2020-05-12 20:55:01 +03:00
parent 63a1a82f38
commit bfb48e3db6
3 changed files with 73 additions and 59 deletions

View file

@ -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

View file

@ -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

View file

@ -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())
}