Merge branch 'develop' of git.pleroma.social:pleroma/pleroma into 1808-pleroma-sucks
[akkoma] / lib / pleroma / web / api_spec / helpers.ex
index ee077a3f9e79b103ed2225f8a847bedb4639ca21..a9cfe0fedf89230c6c6f6aff299eeeacceee08cf 100644 (file)
@@ -5,6 +5,7 @@
 defmodule Pleroma.Web.ApiSpec.Helpers do
   alias OpenApiSpex.Operation
   alias OpenApiSpex.Schema
+  alias Pleroma.Web.ApiSpec.Schemas.BooleanLike
 
   def request_body(description, schema_ref, opts \\ []) do
     media_types = ["application/json", "multipart/form-data", "application/x-www-form-urlencoded"]
@@ -47,12 +48,12 @@ defmodule Pleroma.Web.ApiSpec.Helpers do
     ]
   end
 
-  def embed_relationships_param do
+  def with_relationships_param do
     Operation.parameter(
-      :embed_relationships,
+      :with_relationships,
       :query,
-      :boolean,
-      "Embed relationships into accounts (Pleroma extension)"
+      BooleanLike,
+      "Embed relationships into accounts."
     )
   end
 
@@ -63,4 +64,8 @@ defmodule Pleroma.Web.ApiSpec.Helpers do
   def empty_array_response do
     Operation.response("Empty array", "application/json", %Schema{type: :array, example: []})
   end
+
+  def no_content_response do
+    Operation.response("No Content", "application/json", %Schema{type: :string, example: ""})
+  end
 end