aboutsummaryrefslogtreecommitdiff
path: root/lib/pleroma/web/api_spec/schemas/app_create_request.ex
blob: 8a83abef3eb1f4e5771c01235eec32eb14cbffac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Pleroma: A lightweight social networking server
# Copyright © 2017-2020 Pleroma Authors <https://pleroma.social/>
# SPDX-License-Identifier: AGPL-3.0-only

defmodule Pleroma.Web.ApiSpec.Schemas.AppCreateRequest do
  alias OpenApiSpex.Schema
  require OpenApiSpex

  OpenApiSpex.schema(%{
    title: "AppCreateRequest",
    description: "POST body for creating an app",
    type: :object,
    properties: %{
      client_name: %Schema{type: :string, description: "A name for your application."},
      redirect_uris: %Schema{
        type: :string,
        description:
          "Where the user should be redirected after authorization. To display the authorization code to the user instead of redirecting to a web page, use `urn:ietf:wg:oauth:2.0:oob` in this parameter."
      },
      scopes: %Schema{
        type: :string,
        description: "Space separated list of scopes. If none is provided, defaults to `read`."
      },
      website: %Schema{type: :string, description: "A URL to the homepage of your app"}
    },
    required: [:client_name, :redirect_uris],
    example: %{
      "client_name" => "My App",
      "redirect_uris" => "https://myapp.com/auth/callback",
      "website" => "https://myapp.com/"
    }
  })
end