git.squeep.com Git - akkoma/blob - lib/pleroma/web/api_spec/schemas/account.ex

   1 # Pleroma: A lightweight social networking server
   2 # Copyright © 2017-2020 Pleroma Authors <https://pleroma.social/>
   3 # SPDX-License-Identifier: AGPL-3.0-only
   4
   5 defmodule Pleroma.Web.ApiSpec.Schemas.Account do
   6   alias OpenApiSpex.Schema
   7   alias Pleroma.Web.ApiSpec.Schemas.AccountField
   8   alias Pleroma.Web.ApiSpec.Schemas.AccountRelationship
   9   alias Pleroma.Web.ApiSpec.Schemas.ActorType
  10   alias Pleroma.Web.ApiSpec.Schemas.Emoji
  11   alias Pleroma.Web.ApiSpec.Schemas.FlakeID
  12   alias Pleroma.Web.ApiSpec.Schemas.VisibilityScope
  13
  14   require OpenApiSpex
  15
  16   OpenApiSpex.schema(%{
  17     title: "Account",
  18     description: "Response schema for an account",
  19     type: :object,
  20     properties: %{
  21       acct: %Schema{type: :string},
  22       avatar_static: %Schema{type: :string, format: :uri},
  23       avatar: %Schema{type: :string, format: :uri},
  24       bot: %Schema{type: :boolean},
  25       created_at: %Schema{type: :string, format: "date-time"},
  26       display_name: %Schema{type: :string},
  27       emojis: %Schema{type: :array, items: Emoji},
  28       fields: %Schema{type: :array, items: AccountField},
  29       follow_requests_count: %Schema{type: :integer},
  30       followers_count: %Schema{type: :integer},
  31       following_count: %Schema{type: :integer},
  32       header_static: %Schema{type: :string, format: :uri},
  33       header: %Schema{type: :string, format: :uri},
  34       id: FlakeID,
  35       locked: %Schema{type: :boolean},
  36       note: %Schema{type: :string, format: :html},
  37       statuses_count: %Schema{type: :integer},
  38       url: %Schema{type: :string, format: :uri},
  39       username: %Schema{type: :string},
  40       pleroma: %Schema{
  41         type: :object,
  42         properties: %{
  43           allow_following_move: %Schema{
  44             type: :boolean,
  45             description: "whether the user allows automatically follow moved following accounts"
  46           },
  47           background_image: %Schema{type: :string, nullable: true, format: :uri},
  48           chat_token: %Schema{type: :string},
  49           confirmation_pending: %Schema{
  50             type: :boolean,
  51             description:
  52               "whether the user account is waiting on email confirmation to be activated"
  53           },
  54           hide_favorites: %Schema{type: :boolean},
  55           hide_followers_count: %Schema{
  56             type: :boolean,
  57             description: "whether the user has follower stat hiding enabled"
  58           },
  59           hide_followers: %Schema{
  60             type: :boolean,
  61             description: "whether the user has follower hiding enabled"
  62           },
  63           hide_follows_count: %Schema{
  64             type: :boolean,
  65             description: "whether the user has follow stat hiding enabled"
  66           },
  67           hide_follows: %Schema{
  68             type: :boolean,
  69             description: "whether the user has follow hiding enabled"
  70           },
  71           is_admin: %Schema{
  72             type: :boolean,
  73             description: "whether the user is an admin of the local instance"
  74           },
  75           is_moderator: %Schema{
  76             type: :boolean,
  77             description: "whether the user is a moderator of the local instance"
  78           },
  79           skip_thread_containment: %Schema{type: :boolean},
  80           tags: %Schema{
  81             type: :array,
  82             items: %Schema{type: :string},
  83             description:
  84               "List of tags being used for things like extra roles or moderation(ie. marking all media as nsfw all)."
  85           },
  86           unread_conversation_count: %Schema{
  87             type: :integer,
  88             description: "The count of unread conversations. Only returned to the account owner."
  89           },
  90           notification_settings: %Schema{
  91             type: :object,
  92             properties: %{
  93               followers: %Schema{type: :boolean},
  94               follows: %Schema{type: :boolean},
  95               non_followers: %Schema{type: :boolean},
  96               non_follows: %Schema{type: :boolean},
  97               privacy_option: %Schema{type: :boolean}
  98             }
  99           },
 100           relationship: AccountRelationship,
 101           settings_store: %Schema{
 102             type: :object,
 103             description:
 104               "A generic map of settings for frontends. Opaque to the backend. Only returned in `verify_credentials` and `update_credentials`"
 105           }
 106         }
 107       },
 108       source: %Schema{
 109         type: :object,
 110         properties: %{
 111           fields: %Schema{type: :array, items: AccountField},
 112           note: %Schema{
 113             type: :string,
 114             description:
 115               "Plaintext version of the bio without formatting applied by the backend, used for editing the bio."
 116           },
 117           privacy: VisibilityScope,
 118           sensitive: %Schema{type: :boolean},
 119           pleroma: %Schema{
 120             type: :object,
 121             properties: %{
 122               actor_type: ActorType,
 123               discoverable: %Schema{
 124                 type: :boolean,
 125                 description:
 126                   "whether the user allows discovery of the account in search results and other services."
 127               },
 128               no_rich_text: %Schema{
 129                 type: :boolean,
 130                 description:
 131                   "whether the HTML tags for rich-text formatting are stripped from all statuses requested from the API."
 132               },
 133               show_role: %Schema{
 134                 type: :boolean,
 135                 description:
 136                   "whether the user wants their role (e.g admin, moderator) to be shown"
 137               }
 138             }
 139           }
 140         }
 141       }
 142     },
 143     example: %{
 144       "acct" => "foobar",
 145       "avatar" => "https://mypleroma.com/images/avi.png",
 146       "avatar_static" => "https://mypleroma.com/images/avi.png",
 147       "bot" => false,
 148       "created_at" => "2020-03-24T13:05:58.000Z",
 149       "display_name" => "foobar",
 150       "emojis" => [],
 151       "fields" => [],
 152       "follow_requests_count" => 0,
 153       "followers_count" => 0,
 154       "following_count" => 1,
 155       "header" => "https://mypleroma.com/images/banner.png",
 156       "header_static" => "https://mypleroma.com/images/banner.png",
 157       "id" => "9tKi3esbG7OQgZ2920",
 158       "locked" => false,
 159       "note" => "cofe",
 160       "pleroma" => %{
 161         "allow_following_move" => true,
 162         "background_image" => nil,
 163         "confirmation_pending" => true,
 164         "hide_favorites" => true,
 165         "hide_followers" => false,
 166         "hide_followers_count" => false,
 167         "hide_follows" => false,
 168         "hide_follows_count" => false,
 169         "is_admin" => false,
 170         "is_moderator" => false,
 171         "skip_thread_containment" => false,
 172         "chat_token" =>
 173           "SFMyNTY.g3QAAAACZAAEZGF0YW0AAAASOXRLaTNlc2JHN09RZ1oyOTIwZAAGc2lnbmVkbgYARNplS3EB.Mb_Iaqew2bN1I1o79B_iP7encmVCpTKC4OtHZRxdjKc",
 174         "unread_conversation_count" => 0,
 175         "tags" => [],
 176         "notification_settings" => %{
 177           "followers" => true,
 178           "follows" => true,
 179           "non_followers" => true,
 180           "non_follows" => true,
 181           "privacy_option" => false
 182         },
 183         "relationship" => %{
 184           "blocked_by" => false,
 185           "blocking" => false,
 186           "domain_blocking" => false,
 187           "endorsed" => false,
 188           "followed_by" => false,
 189           "following" => false,
 190           "id" => "9tKi3esbG7OQgZ2920",
 191           "muting" => false,
 192           "muting_notifications" => false,
 193           "requested" => false,
 194           "showing_reblogs" => true,
 195           "subscribing" => false
 196         },
 197         "settings_store" => %{
 198           "pleroma-fe" => %{}
 199         }
 200       },
 201       "source" => %{
 202         "fields" => [],
 203         "note" => "foobar",
 204         "pleroma" => %{
 205           "actor_type" => "Person",
 206           "discoverable" => false,
 207           "no_rich_text" => false,
 208           "show_role" => true
 209         },
 210         "privacy" => "public",
 211         "sensitive" => false
 212       },
 213       "statuses_count" => 0,
 214       "url" => "https://mypleroma.com/users/foobar",
 215       "username" => "foobar"
 216     }
 217   })
 218 end