path: root/docs/locales/zh/api/swagger.yaml

basePath: /
definitions:
    FilterAction:
        title: FilterAction
        description: FilterAction 是针对与过滤规则匹配的贴文所执行的操作。
        type: string
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    InstanceConfigurationEmojis:
        properties:
            emoji_size_limit:
                description: 最大自定义表情文件大小（字节）。
                example: 51200
                format: int64
                type: integer
                x-go-name: EmojiSizeLimit
        title: InstanceConfigurationEmojis
        description: InstanceConfigurationEmojis 结构体包含有关自定义表情的配置信息。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    Link:
        description: Link 代表针对查询请求返回的链接组中的一个“链接”。详见 https://webfinger.net/ 和 https://www.rfc-editor.org/rfc/rfc6415.html#section-3.1
        properties:
            href:
                type: string
                x-go-name: Href
            rel:
                type: string
                x-go-name: Rel
            template:
                type: string
                x-go-name: Template
            type:
                type: string
                x-go-name: Type
        title: Link
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    Mention:
        properties:
            acct:
                description: |-
                    通过webfinger发现的帐户URI。
                    对于本站用户，等于"用户名"，对于外站用户，等于"用户名@域名"。                    
                example: some_user@example.org
                type: string
                x-go-name: Acct
            id:
                description: 被提及的帐户的ID。
                example: 01FBYJHQWQZAVWFRK9PDYTKGMB
                type: string
                x-go-name: ID
            url:
                description: 被提及的账户的Web资料页。
                example: https://example.org/@some_user
                type: string
                x-go-name: URL
            username:
                description: 被提及账户的用户名。
                example: some_user
                type: string
                x-go-name: Username
        title: Mention
        description: Mention 表示对另一个账户的一次提及。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    NodeInfoServices:
        properties:
            inbound:
                items:
                    type: string
                type: array
                x-go-name: Inbound
            outbound:
                items:
                    type: string
                type: array
                x-go-name: Outbound
        title: NodeInfoServices
        description: 表示此节点对入站和出站连接提供的服务。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    NodeInfoSoftware:
        properties:
            homepage:
                description: 该软件的主页，此字段在版本 2.0 中被省略。
                example: https://docs.gotosocial.org/zh-cn/
                type: string
                x-go-name: Homepage
            name:
                example: gotosocial
                type: string
                x-go-name: Name
            repository:
                description: 该软件的存储库，此字段在版本 2.0 中被省略。
                example: https://codeberg.org/superseriousbusiness/gotosocial
                type: string
                x-go-name: Repository
            version:
                example: 0.1.2 1234567
                type: string
                x-go-name: Version
        title: NodeInfoSoftware
        description: NodeInfoSoftware 表示此节点软件的名称和版本号。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    NodeInfoUsage:
        properties:
            localComments:
                format: int64
                type: integer
                x-go-name: LocalComments
            localPosts:
                format: int64
                type: integer
                x-go-name: LocalPosts
            users:
                $ref: '#/definitions/NodeInfoUsers'
        title: NodeInfoUsage
        description: 表示有关此服务器的使用信息，例如用户数量。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    NodeInfoUsers:
        properties:
            activeHalfYear:
                format: int64
                type: integer
                x-go-name: ActiveHalfYear
            activeMonth:
                format: int64
                type: integer
                x-go-name: ActiveMonth
            total:
                format: int64
                type: integer
                x-go-name: Total
        title: NodeInfoUsers
        description: NodeInfoUsers 表示有关服务器上用户的聚合信息。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    Source:
        description: Source 表示用户自己账户的内容展示或发布偏好。在验证和更新凭据时，作为 Account 的一个属性返回的附加实体。
        properties:
            also_known_as_uris:
                description: |-
                    要设置此值，请调用 `/api/v1/accounts/alias`。

                    若为空或为设置，将从json中省略。                    
                items:
                    type: string
                type: array
                x-go-name: AlsoKnownAsURIs
            fields:
                description: 此账户的元数据。
                items:
                    $ref: '#/definitions/field'
                type: array
                x-go-name: Fields
            follow_requests_count:
                description: 待处理的关注请求数量。
                format: int64
                type: integer
                x-go-name: FollowRequestsCount
            language:
                description: 新贴文的默认发布语言。
                type: string
                x-go-name: Language
            note:
                description: 个人资料简介。
                type: string
                x-go-name: Note
            privacy:
                description: |-
                    新贴文的默认可见性。
                    public = 公开贴文
                    unlisted = 未列出/不公开/悄悄公开贴文
                    private = 仅粉丝可见的贴文
                    direct = 私信贴文                    
                type: string
                x-go-name: Privacy
            sensitive:
                description: 是否将新贴文默认标记为敏感。
                type: boolean
                x-go-name: Sensitive
            status_content_type:
                description: 新贴文的默认内容格式。
                type: string
                x-go-name: StatusContentType
            web_layout:
                description: |-
                    账户的网页布局。
                    "microblog": 默认值，经典微博客布局。
                    "gallery": 仅显示媒体的画廊布局。                    
                type: string
                x-go-name: WebLayout
            web_visibility:
                description: |-
                    通过网页端API显示的该账户下贴文的最低可见性。
                    "public" = 默认值，此时仅显示公开贴文。
                    "unlisted" = 显示公开贴文 *和* 未列出的贴文。
                    "none" = 不在网页端显示任何贴文，即使贴文为公开贴文。                    
                type: string
                x-go-name: WebVisibility
        title: Source
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    TimelineMarker:
        properties:
            last_read_id:
                description: 最近查看的内容实体的ID。
                type: string
                x-go-name: LastReadID
            updated_at:
                description: 设定标记时的时间戳 (ISO 8601 Datetime)。
                type: string
                x-go-name: UpdatedAt
            version:
                description: 用于锁定以防止写冲突。
                format: int64
                type: integer
                x-go-name: Version
        title: TimelineMarker
        description: TimelineMarker 包含有关用户在特定时间线上的阅读进度的信息。
        type: object
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    WebPushNotificationPolicy:
        description: WebPushNotificationPolicy 包含可以生成通知的帐户集合。
        type: string
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    account:
        description: Account 是一个 Fediverse 账户的抽象模型。被抽象的账户可以是本站账户，也可以是外站账户。
        properties:
            acct:
                description: |-
                    通过 WebFinger 发现的帐户 URI。
                    对于本站用户，等于“用户名”，对于外站用户，等于“用户名@域名”。                    
                example: some_user@example.org
                type: string
                x-go-name: Acct
            avatar:
                description: 账户头像的网络地址。
                example: https://example.org/media/some_user/avatar/original/avatar.jpeg
                type: string
                x-go-name: Avatar
            avatar_description:
                description: 该账户头像的文字描述，用于提供 Alt 文本。
                example: 一只微笑的树懒的可爱图画。
                type: string
                x-go-name: AvatarDescription
            avatar_media_id:
                description: |-
                    此账户的头像对应的媒体附件的数据库 ID。
                    如果此账户没有上传头像（即默认头像），则省略。                    
                example: 01JAJ3XCD66K3T99JZESCR137W
                type: string
                x-go-name: AvatarMediaID
            avatar_static:
                description: |-
                    该账户头像的静态版本的网络地址。
                    仅在账户的主头像是视频或 gif 时才起实际作用。                    
                example: https://example.org/media/some_user/avatar/static/avatar.png
                type: string
                x-go-name: AvatarStatic
            bot:
                description: 表示账户是一个机器人。
                type: boolean
                x-go-name: Bot
            created_at:
                description: 账户创建时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            custom_css:
                description: 渲染该账户的资料页或贴文页时要包含的自定义 CSS。
                type: string
                x-go-name: CustomCSS
            discoverable:
                description: 表示账户已选择加入内容发现功能。
                type: boolean
                x-go-name: Discoverable
            display_name:
                description: 该账户的昵称
                example: 树懒一号
                type: string
                x-go-name: DisplayName
            emojis:
                description: |-
                    该账户的简介或昵称中使用的自定义表情组成的数组。
                    如果账户被屏蔽，则始终为空。                    
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            enable_rss:
                description: |-
                    账户已启用 RSS 订阅。
                    如果为 false，则省略键/值。                    
                type: boolean
                x-go-name: EnableRSS
            fields:
                description: |-
                    账户设置的附加元数据。
                    如果账户被屏蔽，则始终为空。                    
                items:
                    $ref: '#/definitions/field'
                type: array
                x-go-name: Fields
            followers_count:
                description: 该账户的粉丝数量（数据来源于本站）。
                format: int64
                type: integer
                x-go-name: FollowersCount
            following_count:
                description: 该账户关注的账户数量（数据来源于本站）。
                format: int64
                type: integer
                x-go-name: FollowingCount
            group:
                description: 该账户被标记为 Group 类型的行为体。
                type: boolean
                x-go-name: Group
            header:
                description: 该账户的资料卡横幅背景图片的网络地址。
                example: https://example.org/media/some_user/header/original/header.jpeg
                type: string
                x-go-name: Header
            header_description:
                description: 该账户的资料卡横幅背景图片的文字描述，用于提供 Alt 文本。
                example: 一只树懒和一只小象在一起的可爱图画。
                type: string
                x-go-name: HeaderDescription
            header_media_id:
                description: |-
                    此账户的资料卡横幅背景图片对应的媒体附件的数据库 ID。
                    如果此账户没有上传资料卡横幅背景图（即使用默认横幅背景），则省略。                    
                example: 01JAJ3XCD66K3T99JZESCR137W
                type: string
                x-go-name: HeaderMediaID
            header_static:
                description: |-
                    该账户的资料卡横幅背景图片的静态版本的网络地址。
                    仅在账户的资料卡横幅背景图片是视频或 gif 时才起实际作用。                    
                example: https://example.org/media/some_user/header/static/header.png
                type: string
                x-go-name: HeaderStatic
            hide_collections:
                description: |-
                    账户选择隐藏其粉丝/关注数据。
                    如果为 false，则省略键/值。                    
                type: boolean
                x-go-name: HideCollections
            id:
                description: 账户的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            last_status_at:
                description: 账户最近一条贴文的发布时间 (ISO 8601 Date)。
                example: "2021-07-30"
                type: string
                x-go-name: LastStatusAt
            locked:
                description: 账户选择手动批准关注请求。
                type: boolean
                x-go-name: Locked
            moved:
                $ref: '#/definitions/account'
            note:
                description: 账户的简介。
                type: string
                x-go-name: Note
            role:
                $ref: '#/definitions/accountRole'
            roles:
                description: |-
                    Roles 列出了账户在本站上的公开身份组。
                    与 Role 不同，Roles 始终可用，但从不包含权限细节。
                    对于外站账户，键/值被省略。                    
                items:
                    $ref: '#/definitions/accountDisplayRole'
                type: array
                x-go-name: Roles
            source:
                $ref: '#/definitions/Source'
            statuses_count:
                description: Number of statuses posted by this account, according to our instance. 账户发布的贴文数量 (数据来源于本站)。
                format: int64
                type: integer
                x-go-name: StatusesCount
            suspended:
                description: 账户已被本站封禁。
                type: boolean
                x-go-name: Suspended
            theme:
                description: 用户选择的 CSS 主题文件名，用于在渲染此账户的资料页或贴文页时包含。
                type: string
                x-go-name: Theme
            url:
                description: 账户资料页的 Web 地址。
                example: https://example.org/@some_user
                type: string
                x-go-name: URL
            username:
                description: 账户的用户名，不包括域名。
                example: some_user
                type: string
                x-go-name: Username
        title: Account
        type: object
        x-go-name: Account
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    accountDisplayRole:
        description: AccountDisplayRole 是账户的公开、可显示身份组的抽象模型。它是 AccountRole 的一个子集。
        properties:
            color:
                description: |-
                    Color 是一个带有前导 `#` 的 6 位 CSS 风格十六进制颜色码，如果此身份组没有设置颜色，则为空字符串。
                    GotoSocial 不使用身份组颜色，因此我们将其留空。                    
                type: string
                x-go-name: Color
            id:
                description: |-
                    身份组的 ID。
                    GotoSocial 不使用该属性，但我们将其设置为身份组名称，以防客户端期望唯一 ID。                    
                type: string
                x-go-name: ID
            name:
                description: 身份组的名称。
                type: string
                x-go-name: Name
        title: AccountDisplayRole
        type: object
        x-go-name: AccountDisplayRole
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    accountExportStats:
        description: |-
            AccountExportStats 专门用于在 /api/v1/exports/stats 端点上通知有关导出大小的账户统计信息。            
        properties:
            blocks_count:
                description: 被此账户屏蔽的账户数量。
                example: 15
                format: int64
                type: integer
                x-go-name: BlocksCount
            followers_count:
                description: 此账户的粉丝数量。
                example: 50
                format: int64
                type: integer
                x-go-name: FollowersCount
            following_count:
                description: 此账户关注的账户数量。
                example: 50
                format: int64
                type: integer
                x-go-name: FollowingCount
            lists_count:
                description: 此账户创建的列表数量。
                example: 10
                format: int64
                type: integer
                x-go-name: ListsCount
            media_storage:
                description: 'TODO: 此账户使用的媒体存储空间大小的字符串表示。'
                example: 500MB
                type: string
                x-go-name: MediaStorage
            mutes_count:
                description: 此账户静音/隐藏的账户数量。
                example: 11
                format: int64
                type: integer
                x-go-name: MutesCount
            statuses_count:
                description: 此账户发布的贴文数量。
                example: 81986
                format: int64
                type: integer
                x-go-name: StatusesCount
        type: object
        x-go-name: AccountExportStats
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    accountRelationship:
        properties:
            blocked_by:
                description: 你被此账户屏蔽。
                type: boolean
                x-go-name: BlockedBy
            blocking:
                description: 你屏蔽了此账户。
                type: boolean
                x-go-name: Blocking
            domain_blocking:
                description: 你屏蔽了此账户所在的实例。
                type: boolean
                x-go-name: DomainBlocking
            endorsed:
                description: 你在你的资料页上展示了此账户。
                type: boolean
                x-go-name: Endorsed
            followed_by:
                description: 此账户关注了你。
                type: boolean
                x-go-name: FollowedBy
            following:
                description: 你关注了此账户。
                type: boolean
                x-go-name: Following
            id:
                description: 账户 ID。
                example: 01FBW9XGEP7G6K88VY4S9MPE1R
                type: string
                x-go-name: ID
            muting:
                description: 你静音/隐藏了此账户。
                type: boolean
                x-go-name: Muting
            muting_notifications:
                description: 你静音/隐藏了此账户的通知。
                type: boolean
                x-go-name: MutingNotifications
            note:
                description: 你对此账户的备注。
                type: string
                x-go-name: Note
            notifying:
                description: 你在此账户发布贴文时收到通知。
                type: boolean
                x-go-name: Notifying
            requested:
                description: 你向此账户发送了关注请求，请求正在等待对方处理。
                type: boolean
                x-go-name: Requested
            requested_by:
                description: 此账户请求关注你，请求正在等待你处理。
                type: boolean
                x-go-name: RequestedBy
            showing_reblogs:
                description: 你选择在主页时间线上看到此账户转发的贴文。
                type: boolean
                x-go-name: ShowingReblogs
        title: Relationship
        description: Relationship 表示账户之间的关系。
        type: object
        x-go-name: Relationship
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    accountRole:
        properties:
            color:
                description: |-
                    Color 是一个带有 `#` 前缀的 6 位 CSS 风格十六进制颜色码，如果此身份组没有设置颜色，则为空字符串。
                    GotoSocial 不使用身份组颜色，因此我们将其留空。                    
                type: string
                x-go-name: Color
            highlighted:
                description: |-
                    Highlighted 表示该身份组是否在用户资料页上公开显示。
                    对于 GotoSocial 内置的管理员和站务身份组，此值始终为 true，否则为 false。                    
                type: boolean
                x-go-name: Highlighted
            id:
                description: |-
                    该身份组的 ID。
                    GotoSocial 不使用该属性，但我们将其设置为身份组名称，以防客户端期望唯一 ID。                    
                type: string
                x-go-name: ID
            name:
                description: 身份组的名称。
                type: string
                x-go-name: Name
            permissions:
                description: Permissions 是一个按位序列化的数字字符串，指示用户可以执行哪些管理员/站务操作。
                type: string
                x-go-name: Permissions
        title: AccountRole
        description: AccountRole 是账户的身份组的抽象模型。
        type: object
        x-go-name: AccountRole
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    adminAccountInfo:
        properties:
            account:
                $ref: '#/definitions/account'
            approved:
                description: 账户是否已被批准。
                type: boolean
                x-go-name: Approved
            confirmed:
                description: 账户是否已验证其电子邮件地址。
                type: boolean
                x-go-name: Confirmed
            created_at:
                description: 账户首次被发现的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            created_by_application_id:
                description: 创建此账户的应用程序的 ID。
                type: string
                x-go-name: CreatedByApplicationID
            disabled:
                description: 账户目前是否已被停用。
                type: boolean
                x-go-name: Disabled
            domain:
                description: |-
                    账户所在实例的域名。
                    对于本站账户，为 null。                    
                example: example.org
                type: string
                x-go-name: Domain
            email:
                description: |-
                    与账户关联的电子邮件地址。
                    对于外站账户或没有已知电子邮件地址的账户，为空字符串。                    
                example: someone@somewhere.com
                type: string
                x-go-name: Email
            id:
                description: 该账户在数据库中的 ID。
                example: 01GQ4PHNT622DQ9X95XQX4KKNR
                type: string
                x-go-name: ID
            invite_request:
                description: |-
                    账户填写的注册理由。
                    如果未提供理由或为外站账户，则为 null。                    
                example: 快给爷通过a!!
                type: string
                x-go-name: InviteRequest
            invited_by_account_id:
                description: 邀请此用户的账户的 ID。
                type: string
                x-go-name: InvitedByAccountID
            ip:
                description: |-
                    此账户上次登录的 IP 地址。
                    如果未知，则为 null。                    
                example: 192.0.2.1
                type: string
                x-go-name: IP
            ips:
                description: |-
                    与此账户关联的所有已知 IP 地址。
                    未实现（将始终为空数组）。                    
                example: []
                items: {}
                type: array
                x-go-name: IPs
            locale:
                description: The locale of the account. (ISO 639 Part 1 two-letter language code) 账户的语言偏好。 (ISO 639 Part 1 两字母语言代码)
                example: zh
                type: string
                x-go-name: Locale
            role:
                $ref: '#/definitions/accountRole'
            silenced:
                description: 此账户是否被静音/隐藏。
                type: boolean
                x-go-name: Silenced
            suspended:
                description: 账户目前是否已被封禁。
                type: boolean
                x-go-name: Suspended
            username:
                description: 账户的用户名。
                example: dril
                type: string
                x-go-name: Username
        title: AdminAccountInfo
        description: AdminAccountInfo 是管理员视图下账户详情的抽象模型。
        type: object
        x-go-name: AdminAccountInfo
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    adminActionResponse:
        description: |-
            AdminActionResponse 是服务器对管理员操作的响应的抽象模型。            
        properties:
            action_id:
                description: 操作的内部 ID。
                example: 01H9QG6TZ9W5P0402VFRVM17TH
                type: string
                x-go-name: ActionID
        type: object
        x-go-name: AdminActionResponse
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    adminEmoji:
        properties:
            category:
                description: 于在表情选择器中对自定义表情进行排序。
                example: blobcats
                type: string
                x-go-name: Category
            content_type:
                description: 该表情的 MIME 内容类型。
                example: image/png
                type: string
                x-go-name: ContentType
            disabled:
                description: 若此表情已被管理员操作禁用，则为 true。
                example: false
                type: boolean
                x-go-name: Disabled
            domain:
                description: 该表情的来源实例域名。仅用于外站域名，否则键/值将不会设置。
                example: example.org
                type: string
                x-go-name: Domain
            id:
                description: 该表情的 ID。
                example: 01GEM7SFDZ7GZNRXFVZ3X4E4N1
                type: string
                x-go-name: ID
            shortcode:
                description: 自定义表情的名称。
                example: blobcat_uwu
                type: string
                x-go-name: Shortcode
            static_url:
                description: 一个指向此自定义表情的静态副本的链接。
                example: https://example.org/fileserver/emojis/blogcat_uwu.png
                type: string
                x-go-name: StaticURL
            total_file_size:
                description: 表情占用的总文件大小（字节），包括静态和动画版本。
                example: 69420
                format: int64
                type: integer
                x-go-name: TotalFileSize
            updated_at:
                description: 该表情的最后更新时间。
                example: "2022-10-05T09:21:26.419Z"
                type: string
                x-go-name: UpdatedAt
            uri:
                description: 该表情的 ActivityPub URI。
                example: https://example.org/emojis/016T5Q3SQKBT337DAKVSKNXXW1
                type: string
                x-go-name: URI
            url:
                description: 该自定义表情的 Web URL。
                example: https://example.org/fileserver/emojis/blogcat_uwu.gif
                type: string
                x-go-name: URL
            visible_in_picker:
                description: 该表情是否在实例的表情选择器中可见。
                example: true
                type: boolean
                x-go-name: VisibleInPicker
        title: AdminEmoji
        description: AdminEmoji 是管理员视图下自定义表情的抽象模型。
        type: object
        x-go-name: AdminEmoji
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    adminReport:
        properties:
            account:
                $ref: '#/definitions/adminAccountInfo'
            action_taken:
                description: 管理员是否已对该举报采取行动。
                example: false
                type: boolean
                x-go-name: ActionTaken
            action_taken_at:
                description: |-
                    若已采取行动，在何时采取的行动？ (ISO 8601 Datetime)
                    如果未设置/尚未采取行动，则为null。                    
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ActionTakenAt
            action_taken_by_account:
                $ref: '#/definitions/adminAccountInfo'
            action_taken_comment:
                description: |-
                    若已采取行动，管理员对采取的行动做了什么评论？
                    如果未设置/尚未采取行动，则为null。                    
                example: 账户已被封禁。
                type: string
                x-go-name: ActionTakenComment
            assigned_account:
                $ref: '#/definitions/adminAccountInfo'
            category:
                description: 该举报的类别是？
                example: spam
                type: string
                x-go-name: Category
            comment:
                description: |-
                    该举报创建时提交的评论。
                    如果未提交评论，则为空。                    
                example: 此人一直在骚扰我。
                type: string
                x-go-name: Comment
            created_at:
                description: 举报创建时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            forwarded:
                description: 用于指示是否应将举报抄送外站实例的布尔值。
                example: true
                type: boolean
                x-go-name: Forwarded
            id:
                description: 举报的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            rules:
                description: |-
                    该举报中提交的违反的规则数组。
                    如果未提交规则 ID，则为空。                    
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            statuses:
                description: |-
                    该举报中提交的贴文数组。
                    如果未提交贴文 ID，则为空。                    
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Statuses
            target_account:
                $ref: '#/definitions/adminAccountInfo'
            updated_at:
                description: 针对此举报的最后一次操作的操作时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: UpdatedAt
        title: AdminReport
        description: AdminReport 是管理员视图下举报的抽象模型。
        type: object
        x-go-name: AdminReport
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    application:
        properties:
            client_id:
                description: 应用程序关联的客户端 ID。
                type: string
                x-go-name: ClientID
            client_secret:
                description: 应用程序关联的客户端密钥。
                type: string
                x-go-name: ClientSecret
            created_at:
                description: 应用程序创建时间。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            id:
                description: 应用程序的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            name:
                description: 应用程序的名称。
                example: Moshidon
                type: string
                x-go-name: Name
            redirect_uri:
                description: 授权后重定向 URI，用于应用程序 (OAuth2)。
                example: https://example.org/callback?some=query
                type: string
                x-go-name: RedirectURI
            redirect_uris:
                description: 授权后重定向的 URI 列表，用于应用程序 (OAuth2)。
                example: '[https://example.org/callback?some=query]'
                items:
                    type: string
                type: array
                x-go-name: RedirectURIs
            scopes:
                description: 应用的 OAuth 授权范围。
                items:
                    type: string
                type: array
                x-go-name: Scopes
            vapid_key:
                description: 用于推送 API 的密钥。
                type: string
                x-go-name: VapidKey
            website:
                description: 与应用程序关联的网站 (url)。
                example: https://tusky.app
                type: string
                x-go-name: Website
        title: Application
        description: Application 是对 API 应用程序的抽象模型。
        type: object
        x-go-name: Application
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    attachment:
        properties:
            blurhash:
                description: |-
                    通过 BlurHash 算法计算的哈希，用于在媒体尚未下载时生成彩色预览缩略图。
                    参见 https://github.com/woltapp/blurhash                    
                type: string
                x-go-name: Blurhash
            description:
                description: 用于描述媒体附件内容的 Alt 文本。
                example: 一只橘猫在阳光下打盹。
                type: string
                x-go-name: Description
            id:
                description: 媒体附件的 ID。
                example: 01FC31DZT1AYWDZ8XTCRWRBYRK
                type: string
                x-go-name: ID
            meta:
                $ref: '#/definitions/mediaMeta'
            preview_remote_url:
                description: |-
                    外站服务器上的媒体附件缩略图地址。
                    仅在非本站实例上定义。                    
                example: https://some-other-server.org/attachments/small/ahhhhh.jpeg
                type: string
                x-go-name: PreviewRemoteURL
            preview_url:
                description: 该媒体附件的缩略图地址。
                example: https://example.org/fileserver/some_id/attachments/some_id/small/attachment.jpeg
                type: string
                x-go-name: PreviewURL
            remote_url:
                description: |-
                    外站服务器上的媒体附件原图地址。
                    仅在非本站实例上定义。                    
                example: https://some-other-server.org/attachments/original/ahhhhh.jpeg
                type: string
                x-go-name: RemoteURL
            text_url:
                description: |-
                    该媒体附件的短链接。
                    对于 GoToSocial，该值与 URL 相同，因为我们不创建较短的 URL。                    
                type: string
                x-go-name: TextURL
            type:
                description: 附件的类型。
                example: image
                type: string
                x-go-name: Type
            url:
                description: 附件的原图地址。
                example: https://example.org/fileserver/some_id/attachments/some_id/original/attachment.jpeg
                type: string
                x-go-name: URL
        title: Attachment
        description: Attachment 是媒体附件的抽象模型。
        type: object
        x-go-name: Attachment
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    card:
        properties:
            author_name:
                description: 原始资源的作者。
                example: weewee@buzzfeed.com
                type: string
                x-go-name: AuthorName
            author_url:
                description: 指向原始资源作者的链接。
                example: https://buzzfeed.com/authors/weewee
                type: string
                x-go-name: AuthorURL
            blurhash:
                description: 通过 BlurHash 算法计算的哈希，用于在媒体尚未下载时生成彩色预览缩略图。
                type: string
                x-go-name: Blurhash
            description:
                description: 预览的描述。
                example: 水是湿的吗？这很不好说。在这篇文章中，我们请教了一位专家...
                type: string
                x-go-name: Description
            embed_url:
                description: 用于照片嵌入，而非自定义 HTML。
                type: string
                x-go-name: EmbedURL
            height:
                description: 预览的高度，以像素为单位。
                format: int64
                type: integer
                x-go-name: Height
            html:
                description: 用于生成预览卡片的 HTML。
                type: string
                x-go-name: HTML
            image:
                description: 预览缩略图。
                example: https://example.org/fileserver/preview/thumb.jpg
                type: string
                x-go-name: Image
            provider_name:
                description: 原始资源的提供者。
                example: 惊爆新闻
                type: string
                x-go-name: ProviderName
            provider_url:
                description: 一个指向原始资源提供者的链接。
                example: https://buzzfeed.com
                type: string
                x-go-name: ProviderURL
            title:
                description: 链接到的资源的标题。
                example: 惊爆新闻：水是湿的吗？
                type: string
                x-go-name: Title
            type:
                description: 预览卡片的类型。
                example: link
                type: string
                x-go-name: Type
            url:
                description: 链接指向的资源的地址。
                example: https://buzzfeed.com/some/fuckin/buzzfeed/article
                type: string
                x-go-name: URL
            width:
                description: 预览的宽度，单位为像素。
                format: int64
                type: integer
                x-go-name: Width
        title: Card
        description: Card 表示使用 OpenGraph 标签从 URL 生成的丰富预览卡片。
        type: object
        x-go-name: Card
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    conversation:
        description: |-
            Conversation 表示具有“私信”可见性的对话。            
        properties:
            accounts:
                description: |-
                    对话的参与者。
                    如果这是没有目标账户的对话(即仅自己可见的私信)，
                    则仅包含请求账户本身。否则，将包括对话中的所有其他账户，但不包括请求账户。                    
                items:
                    $ref: '#/definitions/account'
                type: array
                x-go-name: Accounts
            id:
                description: 对话在本地数据库中的 ID。
                type: string
                x-go-name: ID
            last_status:
                $ref: '#/definitions/status'
            unread:
                description: 该对话当前是否被标记为未读？
                type: boolean
                x-go-name: Unread
        type: object
        x-go-name: Conversation
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    debugAPUrlResponse:
        description: |-
            DebugAPUrlResponse 提供对 AP URL 解引用请求的详细调试信息。            
        properties:
            request_headers:
                additionalProperties:
                    items:
                        type: string
                    type: array
                description: 发送请求时使用的 HTTP 标头。
                type: object
                x-go-name: RequestHeaders
            request_url:
                description: 请求的外站 AP URL。
                type: string
                x-go-name: RequestURL
            response_body:
                description: |-
                    外站实例返回的 Body。
                    将是字符串化的字节；可能是 JSON，可能是错误文本，也可能同时是以上两者！                    
                type: string
                x-go-name: ResponseBody
            response_code:
                description: 外站实例返回的 HTTP 状态码。
                format: int64
                type: integer
                x-go-name: ResponseCode
            response_headers:
                additionalProperties:
                    items:
                        type: string
                    type: array
                description: 外站实例返回的 HTTP 标头。
                type: object
                x-go-name: ResponseHeaders
        type: object
        x-go-name: DebugAPUrlResponse
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    defaultPolicies:
        properties:
            direct:
                $ref: '#/definitions/interactionPolicy'
            private:
                $ref: '#/definitions/interactionPolicy'
            public:
                $ref: '#/definitions/interactionPolicy'
            unlisted:
                $ref: '#/definitions/interactionPolicy'
        title: 发起请求的账户的新贴文的默认互动规则。
        type: object
        x-go-name: DefaultPolicies
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    domain:
        description: Domain 表示一个外站实例
        properties:
            comment:
                description: |-
                    如果域名被屏蔽，公开声明的屏蔽原因是什么。
                    可用于在通过 /api/v1/instance 执行序列化/反序列化时替代 `public_comment`。                    
                example: 这个实例有股味
                type: string
                x-go-name: Comment
            domain:
                description: 实例的主机名。
                example: example.org
                type: string
                x-go-name: Domain
            public_comment:
                description: |-
                    如果实例被屏蔽，公开的屏蔽原因是什么。
                    可用于在 **不** 通过 /api/v1/instance 执行序列化/反序列化时替代 `comment`。                    
                example: 它们被骚扰账号攻陷了。
                type: string
                x-go-name: PublicComment
            silenced_at:
                description: 实例被静音/隐藏的时间。对于开放实例，此键将不会存在。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SilencedAt
            suspended_at:
                description: 实例被屏蔽的时间。对于开放实例，此键将不会存在。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SuspendedAt
        type: object
        x-go-name: Domain
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    domainPermission:
        properties:
            comment:
                description: |-
                    如果域名被屏蔽，公开声明的屏蔽原因是什么。
                    可用于在通过 /api/v1/instance 执行序列化/反序列化时替代 `public_comment`。                    
                example: 它们闻起来很糟糕
                type: string
                x-go-name: Comment
            created_at:
                description: 此权限条目创建的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            created_by:
                description: 创建此实例权限条目的账户的 ID。
                example: 01FBW2758ZB6PBR200YPDDJK4C
                type: string
                x-go-name: CreatedBy
            domain:
                description: 此实例的主机名。
                example: example.org
                type: string
                x-go-name: Domain
            id:
                description: 此实例权限条目的 ID。
                example: 01FBW21XJA09XYX51KV5JVBW0F
                readOnly: true
                type: string
                x-go-name: ID
            obfuscate:
                description: 是否在公开此实例权限条目时对域名进行模糊处理。
                example: false
                type: boolean
                x-go-name: Obfuscate
            private_comment:
                description: 对此权限条目的私密评论，仅对本站管理员可见。
                example: 它们管理员都是啥b啊
                type: string
                x-go-name: PrivateComment
            public_comment:
                description: |-
                    若实例被屏蔽，公开的屏蔽原因是什么。
                    可用于在 **不** 通过 /api/v1/instance 执行序列化/反序列化时替代 `comment`。                    
                example: 它们被骚扰账号攻陷了。
                type: string
                x-go-name: PublicComment
            silenced_at:
                description: 该实例被静音/隐藏的时间。对于开放实例，此键将不会存在。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SilencedAt
            subscription_id:
                description: 如果可用，导致此实例权限条目被创建的订阅的 ID。
                example: 01FBW25TF5J67JW3HFHZCSD23K
                type: string
                x-go-name: SubscriptionID
            suspended_at:
                description: 此实例被屏蔽的时间。对于开放实例，此键将不会存在。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: SuspendedAt
        title: DomainPermission
        description: DomainPermission 表示应用于某个实例的权限（显式阻止/允许）。
        type: object
        x-go-name: DomainPermission
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    domainPermissionSubscription:
        properties:
            adopt_orphans:
                description: '若为 true，则此域名权限订阅将“接管”实例上已存在的、符合以下条件的域名权限： 1）它们没有关联的订阅 ID（即，它们是“孤立”的）， 2）它们存在于订阅列表中。这些孤立的域名权限条目将被关联到此订阅的订阅 ID，并由此订阅管理。'
                example: false
                type: boolean
                x-go-name: AdoptOrphans
            as_draft:
                description: 若为 true，则此域名权限订阅将创建为草稿，须由管理员批准后才能生效。若为 false，此域名权限订阅将立即生效。
                example: true
                type: boolean
                x-go-name: AsDraft
            content_type:
                description: 解析权限列表时采用的 MIME 内容类型。
                example: text/csv
                type: string
                x-go-name: ContentType
            count:
                description: 上次（成功）获取时在订阅地址上发现的域名权限条目数量。
                example: 53
                format: uint64
                readOnly: true
                type: integer
                x-go-name: Count
            created_at:
                description: 订阅创建的时间（ISO 8601 Datetime）。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            created_by:
                description: 创建此订阅的帐户的 ID。
                example: 01FBW21XJA09XYX51KV5JVBW0F
                readOnly: true
                type: string
                x-go-name: CreatedBy
            error:
                description: 如果最近的获取尝试失败，此字段将包含与获取尝试相关的错误消息。
                example: Oopsie doopsie, we made a fucky wucky.
                readOnly: true
                type: string
                x-go-name: Error
            fetch_password:
                description: （可选）更新订阅时进行基本身份验证（Basic Auth）的密码。
                example: admin123
                type: string
                x-go-name: FetchPassword
            fetch_username:
                description: （可选）更新订阅时进行基本身份验证（Basic Auth）的用户名。
                example: admin123
                type: string
                x-go-name: FetchUsername
            fetched_at:
                description: 上次更新订阅（不论是否成功）的时间（ISO 8601 Datetime）。
                example: "2021-07-30T09:20:25+00:00"
                readOnly: true
                type: string
                x-go-name: FetchedAt
            id:
                description: 域名权限订阅的 ID。
                example: 01FBW21XJA09XYX51KV5JVBW0F
                readOnly: true
                type: string
                x-go-name: ID
            permission_type:
                description: 域名权限订阅的类型（允许， 阻止）。
                example: block
                type: string
                x-go-name: PermissionType
            priority:
                description: 域名权限订阅的优先级（0-255， 数字越大， 优先级越高）。
                example: 100
                format: uint8
                type: integer
                x-go-name: Priority
            successfully_fetched_at:
                description: 上次成功更新订阅的时间（ISO 8601 Datetime）。
                example: "2021-07-30T09:20:25+00:00"
                readOnly: true
                type: string
                x-go-name: SuccessfullyFetchedAt
            title:
                description: 域名权限订阅的标题。由管理员在创建或更新时设置。
                example: really cool list of neato pals
                type: string
                x-go-name: Title
            uri:
                description: 域名权限订阅的 URI， 用于从中获取域名权限条目列表。
                example: https://www.example.org/blocklists/list1.csv
                type: string
                x-go-name: URI
        title: DomainPermissionSubscription
        description: DomainPermissionSubscription （域名权限订阅）表示一个可以自动更新的域名权限列表订阅（类型可以为允许或阻止）
        type: object
        x-go-name: DomainPermissionSubscription
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    emoji:
        properties:
            category:
                description: 用于在表情选择器中对自定义表情进行排序。
                example: blobcats
                type: string
                x-go-name: Category
            shortcode:
                description: 自定义表情的名称。
                example: blobcat_uwu
                type: string
                x-go-name: Shortcode
            static_url:
                description: 该自定义表情的静态副本链接。
                example: https://example.org/fileserver/emojis/blogcat_uwu.png
                type: string
                x-go-name: StaticURL
            url:
                description: 该自定义表情的 Web URL。
                example: https://example.org/fileserver/emojis/blogcat_uwu.gif
                type: string
                x-go-name: URL
            visible_in_picker:
                description: 该表情是否在实例的表情选择器中可见。
                example: true
                type: boolean
                x-go-name: VisibleInPicker
        title: Emoji
        description: Emoji 表示一个自定义表情。
        type: object
        x-go-name: Emoji
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    emojiCategory:
        properties:
            id:
                description: 自定义表情类别的 ID。
                type: string
                x-go-name: ID
            name:
                description: 自定义表情类别的名称。
                type: string
                x-go-name: Name
        title: EmojiCategory
        description: EmojiCategory 表示自定义表情的类别。
        type: object
        x-go-name: EmojiCategory
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    field:
        properties:
            name:
                description: 该附加字段的键/名称。
                example: 人称代词
                type: string
                x-go-name: Name
            value:
                description: 该附加字段的值。
                example: they/them
                type: string
                x-go-name: Value
            verified_at:
                description: 如果此字段已被验证，是何时验证的？ (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: VerifiedAt
        title: Field
        description: Field 表示要在账户资料上显示的名称/值对。
        type: object
        x-go-name: Field
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterContext:
        description: FilterContext 表示过滤规则要应用到的上下文。Filter API 的 v1 和 v2 使用相同的上下文集合。
        title: FilterContext
        type: string
        x-go-name: FilterContext
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterKeyword:
        properties:
            id:
                description: 数据库中过滤关键词条目的 ID。
                type: string
                x-go-name: ID
            keyword:
                description: 被过滤的文本。
                example: 挂人
                type: string
                x-go-name: Keyword
            whole_word:
                description: 该过滤关键词是否应考虑单词边界？（整词匹配）
                example: true
                type: boolean
                x-go-name: WholeWord
        title: FilterKeyword
        description: FilterKeyword 表示 v2 过滤规则中要过滤的关键词文本。
        type: object
        x-go-name: FilterKeyword
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterResult:
        properties:
            filter:
                $ref: '#/definitions/filterV2'
            keyword_matches:
                description: 该过滤规则中被匹配到的关键词。
                items:
                    type: string
                type: array
                x-go-name: KeywordMatches
            status_matches:
                description: 命中该过滤规则的贴文 ID。
                items:
                    type: string
                type: array
                x-go-name: StatusMatches
        title: FilterResult
        description: FilterResult 与被过滤的贴文一起返回，以解释为什么被过滤。
        type: object
        x-go-name: FilterResult
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterStatus:
        properties:
            id:
                description: 数据库中过滤贴文条目的 ID。
                type: string
                x-go-name: ID
            phrase:
                description: 被过滤的贴文 ID。
                type: string
                x-go-name: StatusID
        title: FilterStatus
        description: FilterStatus 表示 v2 过滤规则中被过滤的贴文 ID。
        type: object
        x-go-name: FilterStatus
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterV1:
        description: |-
            FilterV1 表示用户定义的过滤规则，用于确定哪些贴文不应显示给用户。
            注意，v1 过滤规则在内部处理时会映射到 v2 过滤规则和 v2 过滤关键词。
            若 whole_word 为 true，则客户端应执行：
            为您的应用程序定义“单词组成字符 (word constituent character)”。在官方实现中，它是 [A-Za-z0-9_] (JavaScript) 和 [[:word:]] (Ruby)。
            Ruby 使用 POSIX 字符类 (Letter | Mark | Decimal_Number | Connector_Punctuation)。
            如果短语以单词字符开头，并且匹配范围之前的前一个字符是单词字符，则应将其匹配范围视为不匹配。
            如果短语以单词字符结尾，并且匹配范围之后的下一个字符是单词字符，则应将其匹配范围视为不匹配。
            请查看 Mastodon 源代码中的 app/javascript/mastodon/selectors/index.js 和 app/lib/feed_manager.rb 以获取更多详细信息。            
        properties:
            context:
                description: 该过滤规则被应用到的上下文。
                example:
                    - home
                    - public
                items:
                    $ref: '#/definitions/filterContext'
                minItems: 1
                type: array
                uniqueItems: true
                x-go-name: Context
            expires_at:
                description: 过滤规则不再生效的时间。如果过滤规则不会过期，则为 null。
                example: "2024-02-01T02:57:49Z"
                type: string
                x-go-name: ExpiresAt
            id:
                description: 数据库中过滤规则条目的 ID。
                type: string
                x-go-name: ID
            irreversible:
                description: 命中的条目是否应从用户的时间线/视图中移除，而不是隐藏？
                example: false
                type: boolean
                x-go-name: Irreversible
            phrase:
                description: 被过滤的文本。
                example: 挂人
                type: string
                x-go-name: Phrase
            whole_word:
                description: 过滤规则是否应考虑单词边界？
                example: true
                type: boolean
                x-go-name: WholeWord
        title: FilterV1
        type: object
        x-go-name: FilterV1
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    filterV2:
        description: FilterV2 表示用户定义的过滤规则，用于确定哪些贴文不应显示给用户。v2 过滤规则具有名称，并且可以包含多个短语和贴文 ID 以进行过滤。
        properties:
            context:
                description: 过滤规则应用的上下文。
                example:
                    - home
                    - public
                items:
                    $ref: '#/definitions/filterContext'
                minItems: 1
                type: array
                uniqueItems: true
                x-go-name: Context
            expires_at:
                description: 过滤规则不再生效的时间。如果过滤规则不会过期，则为 null。
                example: "2024-02-01T02:57:49Z"
                type: string
                x-go-name: ExpiresAt
            filter_action:
                $ref: '#/definitions/FilterAction'
            id:
                description: 数据库中过滤规则条目的 ID。
                type: string
                x-go-name: ID
            keywords:
                description: 此过滤规则下的关键词。
                items:
                    $ref: '#/definitions/filterKeyword'
                type: array
                x-go-name: Keywords
            statuses:
                description: 此过滤规则下的贴文。
                items:
                    $ref: '#/definitions/filterStatus'
                type: array
                x-go-name: Statuses
            title:
                description: 此过滤规则的名称。
                example: Linux 相关
                type: string
                x-go-name: Title
        title: FilterV2
        type: object
        x-go-name: FilterV2
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    headerFilter:
        properties:
            created_at:
                description: 标头过滤规则创建时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                readOnly: true
                type: string
                x-go-name: CreatedAt
            created_by:
                description: 创建此标头过滤规则的管理员账户的 ID。
                example: 01FBW2758ZB6PBR200YPDDJK4C
                readOnly: true
                type: string
                x-go-name: CreatedBy
            header:
                description: 此标头过滤规则匹配的 HTTP 标头。
                example: User-Agent
                type: string
                x-go-name: Header
            id:
                description: 此标头过滤规则的 ID。
                example: 01FBW21XJA09XYX51KV5JVBW0F
                readOnly: true
                type: string
                x-go-name: ID
            regex:
                description: 此标头过滤规则的正则表达式。
                example: .*Firefox.*
                type: string
                x-go-name: Regex
        title: HeaderFilter
        description: HeaderFilter 表示应用于特定 HTTP 标头的正则过滤规则（允许/阻止）。
        type: object
        x-go-name: HeaderFilter
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    hostmeta:
        description: 'HostMeta 表示一份 hostmeta 文档。参见: https://www.rfc-editor.org/rfc/rfc6415.html#section-3'
        properties:
            Link:
                items:
                    $ref: '#/definitions/Link'
                type: array
            XMLNS:
                type: string
            XMLName: {}
        title: HostMeta
        type: object
        x-go-name: HostMeta
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceConfigurationAccounts:
        properties:
            allow_custom_css:
                description: 此实例是否允许账户上传用于资料页和贴文页的自定义 CSS。
                example: false
                type: boolean
                x-go-name: AllowCustomCSS
            max_featured_tags:
                description: |-
                    此实例允许每个账户设置的最大特色标签数。                    
                format: int64
                type: integer
                x-go-name: MaxFeaturedTags
            max_profile_fields:
                description: |-
                    此实例允许每个账户设置的最大附加字段数。
                    目前不可配置，硬编码为 6。详见 (https://codeberg.org/superseriousbusiness/gotosocial/issues/1876)                    
                format: int64
                type: integer
                x-go-name: MaxProfileFields
        title: InstanceConfigurationAccounts
        description: InstanceConfigurationAccounts 是实例账户配置参数的抽象模型。
        type: object
        x-go-name: InstanceConfigurationAccounts
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceConfigurationMediaAttachments:
        properties:
            image_matrix_limit:
                description: |-
                    图像的最大尺寸，以像素为单位，高度*宽度。

                    GtS 不对此设置限制，但为了保持兼容性，我们在这里给出 Mastodon 的 4096x4096px 值。                    
                example: 16777216
                format: int64
                type: integer
                x-go-name: ImageMatrixLimit
            image_size_limit:
                description: 图像的最大大小，以字节为单位。
                example: 2097152
                format: int64
                type: integer
                x-go-name: ImageSizeLimit
            supported_mime_types:
                description: 此实例支持上传的 MIME 类型列表。
                example:
                    - image/jpeg
                    - image/gif
                items:
                    type: string
                type: array
                x-go-name: SupportedMimeTypes
            video_frame_rate_limit:
                description: 此实例支持的最大视频帧率。
                example: 60
                format: int64
                type: integer
                x-go-name: VideoFrameRateLimit
            video_matrix_limit:
                description: |-
                    此实例支持的最大视频尺寸，以像素为单位，高度*宽度。

                    GtS 不对此设置限制，但为了保持兼容性，我们在这里给出 Mastodon 的 4096x4096px 值。                    
                example: 16777216
                format: int64
                type: integer
                x-go-name: VideoMatrixLimit
            video_size_limit:
                description: 视频的最大大小，以字节为单位。
                example: 10485760
                format: int64
                type: integer
                x-go-name: VideoSizeLimit
        title: InstanceConfigurationMediaAttachments
        description: InstanceConfigurationMediaAttachments 是实例媒体附件配置参数的抽象模型。
        type: object
        x-go-name: InstanceConfigurationMediaAttachments
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceConfigurationPolls:
        properties:
            max_characters_per_option:
                description: 投票选项中允许的最大字符数。
                example: 50
                format: int64
                type: integer
                x-go-name: MaxCharactersPerOption
            max_expiration:
                description: 投票的最大时长，以秒为单位。
                example: 2629746
                format: int64
                type: integer
                x-go-name: MaxExpiration
            max_options:
                description: 此实例允许的最大投票选项数。
                example: 4
                format: int64
                type: integer
                x-go-name: MaxOptions
            min_expiration:
                description: 投票的最小时长，以秒为单位。
                example: 300
                format: int64
                type: integer
                x-go-name: MinExpiration
        title: InstanceConfigurationPolls
        description: InstanceConfigurationPolls 是实例投票配置参数的抽象模型。
        type: object
        x-go-name: InstanceConfigurationPolls
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceConfigurationStatuses:
        properties:
            characters_reserved_per_url:
                description: 客户端应假设 URL 占用的字符数。
                example: 25
                format: int64
                type: integer
                x-go-name: CharactersReservedPerURL
            max_characters:
                description: 此实例允许的最大贴文长度，以字符为单位。
                example: 5000
                format: int64
                type: integer
                x-go-name: MaxCharacters
            max_media_attachments:
                description: 此实例允许的最大媒体附件数。
                example: 4
                format: int64
                type: integer
                x-go-name: MaxMediaAttachments
            supported_mime_types:
                description: 此实例的贴文可用的 MIME 类型列表。
                example:
                    - text/plain
                    - text/markdown
                items:
                    type: string
                type: array
                x-go-name: SupportedMimeTypes
        title: InstanceConfigurationStatuses
        description: InstanceConfigurationStatuses 是实例贴文配置参数的抽象模型。
        type: object
        x-go-name: InstanceConfigurationStatuses
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceRule:
        properties:
            id:
                type: string
                x-go-name: ID
            text:
                type: string
                x-go-name: Text
        title: InstanceRule
        description: InstanceRule 表示一条实例规则。
        type: object
        x-go-name: InstanceRule
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV1:
        properties:
            account_domain:
                description: |-
                    此实例上的账户的域名。
                    这不一定与 URI 的 Host 部分相同。                    
                example: example.org
                type: string
                x-go-name: AccountDomain
            approval_required:
                description: 新账户注册需要管理员批准。
                type: boolean
                x-go-name: ApprovalRequired
            configuration:
                $ref: '#/definitions/instanceV1Configuration'
            contact_account:
                $ref: '#/definitions/account'
            custom_css:
                description: 此实例的自定义 CSS。
                type: string
                x-go-name: CustomCSS
            debug:
                description: 此实例是否在 DEBUG 模式下运行。如果为 false，则省略。
                type: boolean
                x-go-name: Debug
            description:
                description: |-
                    此实例的描述。

                    应为 HTML 格式，但可能是纯文本。

                    这应该显示在实例的“关于”页面上。                    
                type: string
                x-go-name: Description
            description_text:
                description: 描述的原始（未解析）版本。
                type: string
                x-go-name: DescriptionText
            email:
                description: 用于咨询的电子邮件地址。
                example: social@example.org
                type: string
                x-go-name: Email
            invites_enabled:
                description: 此实例是否允许邀请注册。
                type: boolean
                x-go-name: InvitesEnabled
            languages:
                description: 此实例的主要语言。
                example:
                    - zh
                items:
                    type: string
                type: array
                x-go-name: Languages
            max_toot_chars:
                description: |-
                    此实例允许的最大贴文长度，以字符为单位。

                    这是为了与 Tusky 和其他应用程序兼容而提供的。                    
                example: 5000
                format: uint64
                type: integer
                x-go-name: MaxTootChars
            registrations:
                description: 此实例上启用了新账户注册。
                type: boolean
                x-go-name: Registrations
            rules:
                description: 此实例的规则的条目化列表。
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            short_description:
                description: |-
                    此实例的简要描述。

                    应为 HTML 格式，但可能是纯文本。

                    这应该显示在实例的首页上。                    
                type: string
                x-go-name: ShortDescription
            short_description_text:
                description: 短描述的原始（未解析）版本。
                type: string
                x-go-name: ShortDescriptionText
            stats:
                additionalProperties:
                    format: int64
                    type: integer
                description: |-
                    此实例的统计信息：贴文数、账户数等。
                    值为指针，因为我们不希望在通过 Web 模板渲染统计信息时跳过 0 值。                    
                type: object
                x-go-name: Stats
            terms:
                description: 此实例的条款与条件。
                type: string
                x-go-name: Terms
            terms_text:
                description: 条款与条件的原始（未解析）版本。
                type: string
                x-go-name: TermsRaw
            thumbnail:
                description: 此实例的头像/横幅图像的 URL。
                example: https://example.org/files/instance/thumbnail.jpeg
                type: string
                x-go-name: Thumbnail
            thumbnail_description:
                description: 此实例的头像描述。
                example: 一张可爱的卡通小懒
                type: string
                x-go-name: ThumbnailDescription
            thumbnail_static:
                description: 此实例头像/横幅图的静态版本的 URL。
                example: https://example.org/files/instance/static/thumbnail.webp
                type: string
                x-go-name: ThumbnailStatic
            thumbnail_static_type:
                description: 此实例的头像/横幅图的静态版本的 MIME 类型。
                example: image/webp
                type: string
                x-go-name: ThumbnailStaticType
            thumbnail_type:
                description: 此实例头像的 MIME 类型。
                example: image/png
                type: string
                x-go-name: ThumbnailType
            title:
                description: 实例的标题。
                example: GoToSocial 演示实例
                type: string
                x-go-name: Title
            uri:
                description: 实例的 URI。
                example: https://gts.example.org
                type: string
                x-go-name: URI
            urls:
                $ref: '#/definitions/instanceV1URLs'
            version:
                description: |-
                    此实例部署的 GoToSocial 版本。

                    至少包含一个语义版本号。

                    它还可能包含当前软件的 git 提交短 ID。                    
                example: 0.1.1 cb85f65
                type: string
                x-go-name: Version
        title: InstanceV1
        description: InstanceV1 是关于此实例的信息的抽象模型。
        type: object
        x-go-name: InstanceV1
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV1Configuration:
        properties:
            accounts:
                $ref: '#/definitions/instanceConfigurationAccounts'
            emojis:
                $ref: '#/definitions/InstanceConfigurationEmojis'
            media_attachments:
                $ref: '#/definitions/instanceConfigurationMediaAttachments'
            oidc_enabled:
                description: 若实例使用 OIDC 作为身份验证/身份后端，则为 true，否则省略。
                type: boolean
                x-go-name: OIDCEnabled
            polls:
                $ref: '#/definitions/instanceConfigurationPolls'
            statuses:
                $ref: '#/definitions/instanceConfigurationStatuses'
        title: InstanceV1Configuration
        description: InstanceV1Configuration 是实例配置参数的抽象模型。
        type: object
        x-go-name: InstanceV1Configuration
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV1URLs:
        properties:
            streaming_api:
                description: 用于贴文和通知的流式传输的 Websockets 地址。
                example: wss://example.org
                type: string
                x-go-name: StreamingAPI
        title: InstanceV1URLs
        description: InstanceV1URLs 是客户端应用程序使用的与实例相关的 URL 的抽象模型。
        type: object
        x-go-name: InstanceV1URLs
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2:
        properties:
            account_domain:
                description: |-
                    此实例上的账户的域名。
                    这不一定与 URI 的 Host 部分相同。                    
                example: example.org
                type: string
                x-go-name: AccountDomain
            configuration:
                $ref: '#/definitions/instanceV2Configuration'
            contact:
                $ref: '#/definitions/instanceV2Contact'
            custom_css:
                description: 此实例的自定义 CSS。
                type: string
                x-go-name: CustomCSS
            debug:
                description: 此实例是否在 DEBUG 模式下运行。如果为 false，则省略。
                type: boolean
                x-go-name: Debug
            description:
                description: |-
                    此实例的描述。

                    应为 HTML 格式，但可能是纯文本。

                    这应该显示在实例的“关于”页面上。                    
                type: string
                x-go-name: Description
            description_text:
                description: 描述的原始（未解析）版本。
                type: string
                x-go-name: DescriptionText
            domain:
                description: 实例的域名。
                example: gts.example.org
                type: string
                x-go-name: Domain
            languages:
                description: 实例和实例站务/管理员的主要语言。
                example:
                    - zh
                items:
                    type: string
                type: array
                x-go-name: Languages
            registrations:
                $ref: '#/definitions/instanceV2Registrations'
            rules:
                description: 该实例的规则的条目化列表。
                items:
                    $ref: '#/definitions/instanceRule'
                type: array
                x-go-name: Rules
            source_url:
                description: 本实例部署的软件的源代码 URL，应 AGPL 许可要求提供。
                example: https://codeberg.org/superseriousbusiness/gotosocial
                type: string
                x-go-name: SourceURL
            terms:
                description: 本实例的账户条款与条件。
                type: string
                x-go-name: Terms
            terms_text:
                description: 条款与条件的原始（未解析）版本。
                type: string
                x-go-name: TermsText
            thumbnail:
                $ref: '#/definitions/instanceV2Thumbnail'
            title:
                description: 实例的标题。
                example: GoToSocial 演示实例
                type: string
                x-go-name: Title
            usage:
                $ref: '#/definitions/instanceV2Usage'
            version:
                description: |-
                    此实例部署的 GoToSocial 版本。

                    至少包含一个语义版本号。

                    它还可能包含当前软件的 git 提交短 ID。                    
                example: 0.1.1 cb85f65
                type: string
                x-go-name: Version
        title: InstanceV2
        description: InstanceV2 是关于此实例的信息的抽象模型。
        type: object
        x-go-name: InstanceV2
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Configuration:
        properties:
            accounts:
                $ref: '#/definitions/instanceConfigurationAccounts'
            emojis:
                $ref: '#/definitions/InstanceConfigurationEmojis'
            media_attachments:
                $ref: '#/definitions/instanceConfigurationMediaAttachments'
            oidc_enabled:
                description: 若实例使用 OIDC 作为身份验证/身份后端，则为 true，否则省略。
                type: boolean
                x-go-name: OIDCEnabled
            polls:
                $ref: '#/definitions/instanceConfigurationPolls'
            statuses:
                $ref: '#/definitions/instanceConfigurationStatuses'
            translation:
                $ref: '#/definitions/instanceV2ConfigurationTranslation'
            urls:
                $ref: '#/definitions/instanceV2URLs'
            vapid:
                $ref: '#/definitions/instanceV2ConfigurationVAPID'
        title: InstanceV2Configuration
        description: 此实例的配置值和限制。
        type: object
        x-go-name: InstanceV2Configuration
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2ConfigurationTranslation:
        properties:
            enabled:
                description: |-
                    此实例是否支持翻译 API。
                    由于尚未实现，因此此值始终为 false。                    
                type: boolean
                x-go-name: Enabled
        title: InstanceV2ConfigurationTranslation
        description: 关于翻译功能的提示。
        type: object
        x-go-name: InstanceV2ConfigurationTranslation
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2ConfigurationVAPID:
        properties:
            public_key:
                description: The instance's VAPID public key, Base64-encoded.
                type: string
                x-go-name: PublicKey
        title: InstanceV2ConfigurationVAPID 存储实例的 VAPID 配置信息。
        type: object
        x-go-name: InstanceV2ConfigurationVAPID
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Contact:
        properties:
            account:
                $ref: '#/definitions/account'
            email:
                description: |-
                    可用于咨询和问题反馈的电子邮件地址。
                    如果未设置电子邮件地址，则为空字符串。                    
                example: someone@example.org
                type: string
                x-go-name: Email
        title: InstanceV2Contact
        description: 此实例的联系信息。
        type: object
        x-go-name: InstanceV2Contact
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Registrations:
        properties:
            approval_required:
                description: 此实例是否需要管理员批准新账户注册。
                example: true
                type: boolean
                x-go-name: ApprovalRequired
            enabled:
                description: 是否开放注册。
                example: false
                type: boolean
                x-go-name: Enabled
            message:
                description: |-
                    一条自定义消息（HTML 字符串），用于在关闭注册时显示。                    
                example: <p>由于骚扰猖獗，example.org 目前关闭了注册，请联系管理员以获取帮助。</p>
                type: string
                x-go-name: Message
        title: InstanceV2Registrations
        description: 此实例有关注册的信息。
        type: object
        x-go-name: InstanceV2Registrations
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Thumbnail:
        properties:
            blurhash:
                description: |-
                    通过 BlurHash 算法计算的哈希，用于在媒体尚未下载时生成彩色预览缩略图。                    
                example: UeKUpFxuo~R%0nW;WCnhF6RjaJt757oJodS$
                type: string
                x-go-name: Blurhash
            static_url:
                description: 缩略图图像的静态版本的 URL。
                example: https://example.org/fileserver/01BPSX2MKCRVMD4YN4D71G9CP5/attachment/static/01H88X0KQ2DFYYDSWYP93VDJZA.webp
                type: string
                x-go-name: StaticURL
            thumbnail_description:
                description: |-
                    实例缩略图的描述。
                    如果没有描述可用，则不设置键/值。                    
                example: 一只可爱的小懒
                type: string
                x-go-name: Description
            thumbnail_static_type:
                description: |-
                    实例缩略图的静态版本的 MIME 类型。
                    如果类型未知，则不设置键/值。                    
                example: image/png
                type: string
                x-go-name: StaticType
            thumbnail_type:
                description: |-
                    实例缩略图的 MIME 类型。
                    如果类型未知，则不设置键/值。                    
                example: image/png
                type: string
                x-go-name: Type
            url:
                description: 缩略图的 URL。
                example: https://example.org/fileserver/01BPSX2MKCRVMD4YN4D71G9CP5/attachment/original/01H88X0KQ2DFYYDSWYP93VDJZA.png
                type: string
                x-go-name: URL
            versions:
                $ref: '#/definitions/instanceV2ThumbnailVersions'
        title: InstanceV2Thumbnail
        description: 代表此实例的图像。
        type: object
        x-go-name: InstanceV2Thumbnail
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2ThumbnailVersions:
        properties:
            '@1x':
                description: |-
                    此缩略图的 1 倍分辨率缩放版本的 URL。
                    如果未提供此缩放版本，则不设置键/值。                    
                type: string
                x-go-name: Size1URL
            '@2x':
                description: |-
                    此缩略图的 2 倍分辨率缩放版本的 URL。
                    如果未提供此缩放版本，则不设置键/值。                    
                type: string
                x-go-name: Size2URL
        title: InstanceV2ThumbnailVersions
        description: 缩略图的高分辨率版本，用于高 DPI 屏幕。
        type: object
        x-go-name: InstanceV2ThumbnailVersions
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2URLs:
        properties:
            streaming:
                description: 用于流式传输贴文和通知的 Websockets 地址。
                example: wss://example.org
                type: string
                x-go-name: Streaming
        title: InstanceV2URLs
        description: InstanceV2URLs 是客户端应用程序使用的与实例相关的 URL 的抽象模型。
        type: object
        x-go-name: InstanceV2URLs
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Usage:
        properties:
            users:
                $ref: '#/definitions/instanceV2Users'
        title: InstanceV2Usage
        description: InstanceV2Usage 是关于此实例的使用数据的抽象模型。
        type: object
        x-go-name: InstanceV2Usage
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    instanceV2Users:
        properties:
            active_month:
                description: |-
                    此实例过去 4 周内的活跃用户数。
                    目前未实现：将始终为 0。                    
                example: 0
                format: int64
                type: integer
                x-go-name: ActiveMonth
        title: InstanceV2Users
        description: 此实例的用户使用数据。
        type: object
        x-go-name: InstanceV2Users
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    interactionPolicy:
        properties:
            can_favourite:
                $ref: '#/definitions/interactionPolicyRules'
            can_reblog:
                $ref: '#/definitions/interactionPolicyRules'
            can_reply:
                $ref: '#/definitions/interactionPolicyRules'
        title: InteractionPolicy
        description: 某条贴文的互动规则。
        type: object
        x-go-name: InteractionPolicy
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    interactionPolicyRules:
        properties:
            always:
                description: 始终可以执行此类互动的账户的规则条目。
                items:
                    $ref: '#/definitions/interactionPolicyValue'
                type: array
                x-go-name: Always
            with_approval:
                description: 执行此类互动需要批准的账户的规则条目。
                items:
                    $ref: '#/definitions/interactionPolicyValue'
                type: array
                x-go-name: WithApproval
        title: InteractionPolicyRules
        description: 某类互动的规则。
        type: object
        x-go-name: PolicyRules
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    interactionPolicyValue:
        description: |-
            一条贴文的互动规则条目。
            可以是以下内部关键字之一，也可以是一个完整的 ActivityPub Actor URI，如 "https://example.org/users/some_user"。

            内部关键字：

            public    - 公开，即任何可以根据其可见性级别看到此贴文的人。
            followers - 贴文作者的粉丝。
            following - 贴文作者关注的人。
            mutuals   - 贴文作者的互相关注（保留，未使用）。
            mentioned - 在贴文中提到的账户，或者在贴文中回复的账户。
            author    - 贴文作者本人。
            me        - 如果请求是由授权用户发出的，则 "me" 代表发出请求的、现在正在查询此互动策略的用户。            
        title: InteractionPolicyValue
        type: string
        x-go-name: PolicyValue
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    interactionRequest:
        properties:
            accepted_at:
                description: The timestamp that the interaction request was accepted (ISO 8601 Datetime). Field omitted if request not accepted (yet). 互动请求被接受的时间戳 (ISO 8601 Datetime)。如果请求尚未被接受，则省略此字段。
                type: string
                x-go-name: AcceptedAt
            account:
                $ref: '#/definitions/account'
            created_at:
                description: 互动请求的时间戳 (ISO 8601 Datetime)
                type: string
                x-go-name: CreatedAt
            id:
                description: 互动请求在数据库中的 ID。
                type: string
                x-go-name: ID
            rejected_at:
                description: 互动请求被拒绝的时间戳 (ISO 8601 Datetime)。如果请求尚未被拒绝，则省略此字段。
                type: string
                x-go-name: RejectedAt
            reply:
                $ref: '#/definitions/status'
            status:
                $ref: '#/definitions/status'
            type:
                description: |-
                    该互动请求所涉及的互动类型。

                    `favourite` - 有人点赞了一条贴文。
                    `reply` - 有人回复了一条贴文。
                    `reblog` - 有人转发了一条贴文。                    
                type: string
                x-go-name: Type
            uri:
                description: 接受或拒绝的 URI。仅在设置了 accepted_at 或 rejected_at 时设置，否则省略。
                type: string
                x-go-name: URI
        title: InteractionRequest
        description: InteractionRequest 表示待处理、已批准或已拒绝的点赞、回复或转发互动。
        type: object
        x-go-name: InteractionRequest
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    list:
        properties:
            exclusive:
                description: |-
                    此列表是否为单独列表。
                    如果为 true，则在主页时间线中隐藏此列表的成员的贴文。                    
                type: boolean
                x-go-name: Exclusive
            id:
                description: 列表的 ID。
                type: string
                x-go-name: ID
            replies_policy:
                description: |-
                    此列表的回复显示规则。
                    followed = 显示任何对已关注用户的回复
                    list = 显示对列表成员的回复
                    none = 不显示任何回复                    
                type: string
                x-go-name: RepliesPolicy
            title:
                description: 用户设定的列表名称。
                type: string
                x-go-name: Title
        title: List
        description: List 表示用户为关注的账户创建的列表。
        type: object
        x-go-name: List
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    markers:
        properties:
            home:
                $ref: '#/definitions/TimelineMarker'
            notifications:
                $ref: '#/definitions/TimelineMarker'
        title: Marker
        description: Marker 表示用户时间线中的上次阅读位置。
        type: object
        x-go-name: Marker
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    mediaDimensions:
        properties:
            aspect:
                description: |-
                    媒体附件的宽高比。
                    等于宽度 / 高度。                    
                example: 1.777777778
                format: float
                type: number
                x-go-name: Aspect
            bitrate:
                description: 媒体附件的比特率，以每秒位数为单位。
                example: 1000000
                format: uint64
                type: integer
                x-go-name: Bitrate
            duration:
                description: |-
                    媒体的时长（秒）。
                    仅对视频和音频设置。                    
                example: 5.43
                format: float
                type: number
                x-go-name: Duration
            frame_rate:
                description: |-
                    媒体的帧率。
                    仅对视频和 GIF 设置。                    
                example: "30"
                type: string
                x-go-name: FrameRate
            height:
                description: |-
                    媒体的高度（像素）。
                    对于音频不设置。                    
                example: 1080
                format: int64
                type: integer
                x-go-name: Height
            size:
                description: |-
                    媒体的尺寸，格式为 `[width]x[height]`。
                    对于音频不设置。                    
                example: 1920x1080
                type: string
                x-go-name: Size
            width:
                description: |-
                    媒体的宽度（像素）。
                    对于音频不设置。                    
                example: 1920
                format: int64
                type: integer
                x-go-name: Width
        title: MediaDimensions
        description: MediaDimensions 是一份媒体附件的详细属性的抽象模型。
        type: object
        x-go-name: MediaDimensions
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    mediaFocus:
        properties:
            x:
                description: |-
                    焦点的 x 轴位置，应在 -1 和 1 之间                    
                format: float
                type: number
                x-go-name: X
            "y":
                description: |-
                    焦点的 y 轴位置，应在 -1 和 1 之间                    
                format: float
                type: number
                x-go-name: "Y"
        title: MediaFocus
        description: MediaFocus 是媒体附件的焦点的抽象模型。
        type: object
        x-go-name: MediaFocus
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    mediaMeta:
        description: MediaMeta 是媒体附件的元数据的抽象模型。这可以是有关图像、音频文件、视频等的元数据。
        properties:
            focus:
                $ref: '#/definitions/mediaFocus'
            original:
                $ref: '#/definitions/mediaDimensions'
            small:
                $ref: '#/definitions/mediaDimensions'
        title: MediaMeta
        type: object
        x-go-name: MediaMeta
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    mutedAccount:
        properties:
            acct:
                description: |-
                    通过 webfinger 发现的账户 URI。
                    对于本地用户，等于用户名；对于远程用户，等于用户名@域名。                    
                example: some_user@example.org
                type: string
                x-go-name: Acct
            avatar:
                description: 该账户的头像的 Web 地址。
                example: https://example.org/media/some_user/avatar/original/avatar.jpeg
                type: string
                x-go-name: Avatar
            avatar_description:
                description: 该账户的头像描述，用于 alt 文本。
                example: 一张微笑的树懒的可爱图画。
                type: string
                x-go-name: AvatarDescription
            avatar_media_id:
                description: |-
                    此账户的头像对应的媒体附件的数据库 ID。
                    如果此账户没有上传头像（即默认头像），则省略。                    
                example: 01JAJ3XCD66K3T99JZESCR137W
                type: string
                x-go-name: AvatarMediaID
            avatar_static:
                description: |-
                    账户头像的静态版本的 Web 地址。
                    仅在账户的主头像是视频或 gif 时才有用。                    
                example: https://example.org/media/some_user/avatar/static/avatar.png
                type: string
                x-go-name: AvatarStatic
            bot:
                description: 账户被标记为机器人。
                type: boolean
                x-go-name: Bot
            created_at:
                description: 该账户创建的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            custom_css:
                description: 渲染此账户的资料页或贴文页时包含的自定义 CSS。
                type: string
                x-go-name: CustomCSS
            discoverable:
                description: 账户选择加入发现功能。
                type: boolean
                x-go-name: Discoverable
            display_name:
                description: 账户的昵称。
                example: big jeff (he/him)
                type: string
                x-go-name: DisplayName
            emojis:
                description: |-
                    账户的简介或显示名称中使用的自定义表情符号的数组。
                    对于被屏蔽的账户为空。                    
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            enable_rss:
                description: |-
                    账户已启用 RSS 订阅。
                    如果为 false，则省略键/值。                    
                type: boolean
                x-go-name: EnableRSS
            fields:
                description: |-
                    账户资料中的附加元数据。
                    对于被屏蔽的账户为空。                    
                items:
                    $ref: '#/definitions/field'
                type: array
                x-go-name: Fields
            followers_count:
                description: 该账户的粉丝数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: FollowersCount
            following_count:
                description: 该账户关注的账户数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: FollowingCount
            group:
                description: 该账户被标记为 Group 类型的行为体。
                type: boolean
                x-go-name: Group
            header:
                description: 账户资料卡横幅背景图的 Web 地址。
                example: https://example.org/media/some_user/header/original/header.jpeg
                type: string
                x-go-name: Header
            header_description:
                description: 账户资料卡横幅背景图的描述，用于 alt 文本。
                example: 花开富贵。
                type: string
                x-go-name: HeaderDescription
            header_media_id:
                description: |-
                    此账户的资料卡横幅背景图片对应的媒体附件的数据库 ID。
                    如果此账户没有上传资料卡横幅背景图（即使用默认横幅背景），则省略。                    
                example: 01JAJ3XCD66K3T99JZESCR137W
                type: string
                x-go-name: HeaderMediaID
            header_static:
                description: |-
                    账户资料卡横幅背景图的静态版本的 Web 地址。
                    仅在账户的主横幅是视频或 gif 时才有用。                    
                example: https://example.org/media/some_user/header/static/header.png
                type: string
                x-go-name: HeaderStatic
            hide_collections:
                description: |-
                    账户选择隐藏他们的粉丝/关注数据。
                    如果为 false，则省略键/值。                    
                type: boolean
                x-go-name: HideCollections
            id:
                description: 账户 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            last_status_at:
                description: 账户上次发帖的时间 (ISO 8601 Date)。
                example: "2021-07-30"
                type: string
                x-go-name: LastStatusAt
            locked:
                description: 账户手动批准关注请求。
                type: boolean
                x-go-name: Locked
            moved:
                $ref: '#/definitions/account'
            mute_expires_at:
                description: |-
                    如果此账户被静音/隐藏，静音/隐藏将在何时到期 (ISO 8601 Datetime)。
                    如果静音/隐藏是永久的，值将为 null。                    
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: MuteExpiresAt
            note:
                description: 该账户的简介/描述。
                type: string
                x-go-name: Note
            role:
                $ref: '#/definitions/accountRole'
            roles:
                description: |-
                    Roles 列出了账户在本实例上的公开身份。
                    与 Role 不同，此属性始终可用的，但从不包含权限细节。                    
                items:
                    $ref: '#/definitions/accountDisplayRole'
                type: array
                x-go-name: Roles
            source:
                $ref: '#/definitions/Source'
            statuses_count:
                description: 该账户发布的贴文数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: StatusesCount
            suspended:
                description: 账户已被本站实例封禁。
                type: boolean
                x-go-name: Suspended
            theme:
                description: 用户选择的 CSS 主题的文件名，用于在渲染此账户的资料页或贴文页时包含。例如，`blurple-light.css`。
                type: string
                x-go-name: Theme
            url:
                description: 该账户资料页的 Web 地址。
                example: https://example.org/@some_user
                type: string
                x-go-name: URL
            username:
                description: 账户的用户名，不包括域名。
                example: some_user
                type: string
                x-go-name: Username
        title: MutedAccount
        description: MutedAccount 扩展了 Account，其中包含仅静音/隐藏用户列表使用的字段。
        type: object
        x-go-name: MutedAccount
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    nodeinfo:
        description: 'NodeInfo 表示版本 2.1 或版本 2.0 的 nodeinfo 数据结构。参见: https://nodeinfo.diaspora.software/schema.html'
        properties:
            metadata:
                additionalProperties: {}
                description: 自由形式的键值对，用于软件特定值。客户端不应依赖于任何特定的键存在。
                type: object
                x-go-name: Metadata
            openRegistrations:
                description: 此服务器是否开放自主注册。
                example: false
                type: boolean
                x-go-name: OpenRegistrations
            protocols:
                description: 服务器支持的协议。
                items:
                    type: string
                type: array
                x-go-name: Protocols
            services:
                $ref: '#/definitions/NodeInfoServices'
            software:
                $ref: '#/definitions/NodeInfoSoftware'
            usage:
                $ref: '#/definitions/NodeInfoUsage'
            version:
                description: NodeInfo 数据结构版本。
                example: "2.0"
                type: string
                x-go-name: Version
        title: Nodeinfo
        type: object
        x-go-name: Nodeinfo
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    notification:
        properties:
            account:
                $ref: '#/definitions/account'
            created_at:
                description: 通知的时间戳 (ISO 8601 Datetime)
                type: string
                x-go-name: CreatedAt
            id:
                description: 通知在数据库中的 ID。
                type: string
                x-go-name: ID
            status:
                $ref: '#/definitions/status'
            type:
                description: |-
                    触发通知的事件类型。
                    follow = 有人关注了你。`account` 将被设置。
                    follow_request = 有人请求关注你。`account` 将被设置。
                    mention = 有人在他们的贴文中提到了你。`status` 将被设置。`account` 将被设置。
                    reblog = 有人转发了你的一条贴文。`status` 将被设置。`account` 将被设置。
                    favourite = 有人点赞了你的一条贴文。`status` 将被设置。`account` 将被设置。
                    poll = 你参与或创建的一次投票已结束。`status` 将被设置。`account` 将被设置。
                    status = 你设置的接收发帖通知的某个账户发布了一条贴文。`status` 将被设置。`account` 将被设置。
                    admin.sign_up = 有人在实例上注册了一个新账户。`account` 将被设置。                    
                type: string
                x-go-name: Type
        title: Notification
        description: Notification 表示与用户相关的事件的通知。
        type: object
        x-go-name: Notification
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    oauthToken:
        properties:
            access_token:
                description: 用于身份验证的访问令牌。
                type: string
                x-go-name: AccessToken
            created_at:
                description: 生成 OAuth 令牌的时间 (UNIX 时间戳格式的秒)。
                example: 1627644520
                format: int64
                type: integer
                x-go-name: CreatedAt
            scope:
                description: 此令牌被授予的 OAuth 作用域，以空格分隔。
                example: read write admin
                type: string
                x-go-name: Scope
            token_type:
                description: OAuth 令牌类型。将始终为 'Bearer'。
                example: bearer
                type: string
                x-go-name: TokenType
        title: Token
        description: Token 表示用于 GoToSocial API 身份验证和执行操作的 OAuth 令牌。
        type: object
        x-go-name: Token
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    poll:
        properties:
            emojis:
                description: 渲染投票选项时使用的自定义表情符号。
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            expired:
                description: 投票是否已结束？
                type: boolean
                x-go-name: Expired
            expires_at:
                description: 投票结束时间 (ISO 8601 Datetime)。
                type: string
                x-go-name: ExpiresAt
            id:
                description: 数据库中投票的 ID。
                example: 01FBYKMD1KBMJ0W6JF1YZ3VY5D
                type: string
                x-go-name: ID
            multiple:
                description: 投票是否允许多选？
                type: boolean
                x-go-name: Multiple
            options:
                description: 投票的选项。
                items:
                    $ref: '#/definitions/pollOption'
                type: array
                x-go-name: Options
            own_votes:
                description: |-
                    当使用用户令牌调用时，令牌关联的授权用户选择了哪些选项？包含选项的索引值数组。

                    未提供用户令牌时省略。                    
                items:
                    format: int64
                    type: integer
                type: array
                x-go-name: OwnVotes
            voted:
                description: |-
                    当使用用户令牌调用时，令牌关联的授权用户是否已投票？

                    未提供用户令牌时省略。                    
                type: boolean
                x-go-name: Voted
            voters_count:
                description: 多选投票中有多少个独立账户投票。
                format: int64
                type: integer
                x-go-name: VotersCount
            votes_count:
                description: 收到了多少票。
                format: int64
                type: integer
                x-go-name: VotesCount
        title: Poll
        description: Poll 表示一个附加到贴文的投票。
        type: object
        x-go-name: Poll
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    pollOption:
        properties:
            title:
                description: 投票选项的文本值。格式为字符串。
                type: string
                x-go-name: Title
            votes_count:
                description: 该选项收到的票数。
                format: int64
                type: integer
                x-go-name: VotesCount
        title: PollOption
        description: PollOption 表示不同投票选项的当前投票计数。
        type: object
        x-go-name: PollOption
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    report:
        properties:
            action_taken:
                description: 管理员是否已对此举报采取行动。
                example: false
                type: boolean
                x-go-name: ActionTaken
            action_taken_at:
                description: |-
                    若已采取行动，在何时采取行动？(ISO 8601 Datetime)
                    如果未设置/尚未采取行动，则为null。                    
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ActionTakenAt
            action_taken_comment:
                description: |-
                    若已采取行动，管理员在采取行动时发表了什么评论？
                    如果未设置/尚未采取行动，则为null。                    
                example: 账户已被封禁。
                type: string
                x-go-name: ActionTakenComment
            category:
                description: 此举报是在哪个类别下创建的？
                example: spam
                type: string
                x-go-name: Category
            comment:
                description: |-
                    提交举报时附带的评论。
                    如果未提交评论，则为空。                    
                example: 此人一直在骚扰我。
                type: string
                x-go-name: Comment
            created_at:
                description: 举报被创建的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            forwarded:
                description: 用于指示是否应将举报抄送到外站实例的布尔值。
                example: true
                type: boolean
                x-go-name: Forwarded
            id:
                description: 举报的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            rule_ids:
                description: |-
                    与该举报一并提交的实例规则的 ID 数组。
                    如果未提交规则 ID，则为空。                    
                example:
                    - 01GPBN5YDY6JKBWE44H7YQBDCQ
                    - 01GPBN65PDWSBPWVDD0SQCFFY3
                items:
                    type: string
                type: array
                x-go-name: RuleIDs
            status_ids:
                description: |-
                    与此举报一起提交的贴文的 ID 数组。
                    如果未提交贴文 ID，则为空。                    
                example:
                    - 01GPBN5YDY6JKBWE44H7YQBDCQ
                    - 01GPBN65PDWSBPWVDD0SQCFFY3
                items:
                    type: string
                type: array
                x-go-name: StatusIDs
            target_account:
                $ref: '#/definitions/account'
        title: Report
        description: Report 是提交给实例的一份举报的抽象模型，可以通过客户端 API 或联合 API 提交。
        type: object
        x-go-name: Report
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    searchResult:
        properties:
            accounts:
                items:
                    $ref: '#/definitions/account'
                type: array
                x-go-name: Accounts
            hashtags:
                description: 若为 API v1，则为字符串切片；若为 API v2，则为话题标签切片。
                items: {}
                type: array
                x-go-name: Hashtags
            statuses:
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Statuses
        title: SearchResult
        description: SearchResult 是一次搜索结果的抽象模型。
        type: object
        x-go-name: SearchResult
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    status:
        properties:
            account:
                $ref: '#/definitions/account'
            application:
                $ref: '#/definitions/application'
            bookmarked:
                description: 此贴文已被查看的账户收藏。
                type: boolean
                x-go-name: Bookmarked
            card:
                $ref: '#/definitions/card'
            content:
                description: 此贴文的内容。应为 HTML，但在某些情况下也可能为纯文本。
                example: <p>你好，我是一条嘟文。</p>
                type: string
                x-go-name: Content
            created_at:
                description: 此贴文的创建时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            edited_at:
                description: 此贴文上次被编辑的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: EditedAt
            emojis:
                description: 此贴文内容中使用的自定义表情符号。
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            favourited:
                description: 此贴文已被查看它的账户点赞。
                type: boolean
                x-go-name: Favourited
            favourites_count:
                description: 此贴文收到的点赞数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: FavouritesCount
            filtered:
                description: 此贴文命中的过滤规则列表，如果有命中的过滤规则，还会包含命中原因。
                items:
                    $ref: '#/definitions/filterResult'
                type: array
                x-go-name: Filtered
            id:
                description: 此贴文的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            in_reply_to_account_id:
                description: 此贴文回复的账户的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToAccountID
            in_reply_to_id:
                description: 此贴文回复的贴文的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToID
            interaction_policy:
                $ref: '#/definitions/interactionPolicy'
            language:
                description: |-
                    此贴文的主要语言 (ISO 639 Part 1 两字母语言代码)。当语言未知时将为 null。                    
                example: en
                type: string
                x-go-name: Language
            local_only:
                description: 若贴文不参与联合，则设置为 "true"；否则省略。
                type: boolean
                x-go-name: LocalOnly
            media_attachments:
                description: 附于到此贴文的媒体。
                items:
                    $ref: '#/definitions/attachment'
                type: array
                x-go-name: MediaAttachments
            mentions:
                description: 此贴文内容中提及的用户。
                items:
                    $ref: '#/definitions/Mention'
                type: array
                x-go-name: Mentions
            muted:
                description: 此贴文下的回复已被查看它的账户静音。
                type: boolean
                x-go-name: Muted
            pinned:
                description: 此贴文已被查看它的账户置顶（仅适用于您自己的贴文）。
                type: boolean
                x-go-name: Pinned
            poll:
                $ref: '#/definitions/poll'
            reblog:
                $ref: '#/definitions/statusReblogged'
            reblogged:
                description: 此贴文已被查看它的账户转发。
                type: boolean
                x-go-name: Reblogged
            reblogs_count:
                description: 此贴文被转发的次数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: ReblogsCount
            replies_count:
                description: 此贴文的回复数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: RepliesCount
            sensitive:
                description: 此贴文包含敏感内容。
                example: false
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: 此贴文的主题、摘要或内容警告。
                example: NSFW 警告
                type: string
                x-go-name: SpoilerText
            tags:
                description: 贴文内容中使用的话题标签。
                items:
                    $ref: '#/definitions/tag'
                type: array
                x-go-name: Tags
            text:
                description: |-
                    贴文的纯文本内容。当贴文被删除时返回，以便用户可以从源文本重新起草，而无需客户端从 HTML 内容中逆向出原始文本。                    
                type: string
                x-go-name: Text
            uri:
                description: 此贴文的 ActivityPub URI。等同于贴文的 activitypub ID。
                example: https://example.org/users/some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URI
            url:
                description: 此贴文的公开 Web URL。仅当贴文的可见性为 'public' 时，此链接才有效。
                example: https://example.org/@some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URL
            visibility:
                description: 此贴文的可见性。
                example: unlisted
                type: string
                x-go-name: Visibility
        title: Status
        description: Status 表示一条贴文或帖子。
        type: object
        x-go-name: Status
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    statusEdit:
        description: |-
            StatusEdit 表示一条贴文的一个历史修订版本，包含该修订版本的状态的部分信息。            
        properties:
            account:
                $ref: '#/definitions/account'
            content:
                description: |-
                    本次修订的贴文内容。
                    应为 HTML，但在某些情况下也可能为纯文本。                    
                example: <p>这是一条嘟文。</p>
                type: string
                x-go-name: Content
            content_type:
                description: |-
                    用于解析帖文文本的内容格式。
                    当帖文被删除时会返回该值，因此如果用户重新撰写消息，
                    客户端可以默认使用相同的内容格式。                    
                type: string
                x-go-name: ContentType
            created_at:
                description: 此修订版本创建的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            emojis:
                description: 渲染此贴文时用到的自定义表情符号。
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            media_attachments:
                description: 此贴文随附的媒体。
                items:
                    $ref: '#/definitions/attachment'
                type: array
                x-go-name: MediaAttachments
            poll:
                $ref: '#/definitions/poll'
            sensitive:
                description: 贴文在本次编辑中被标记为敏感。
                example: false
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: 本次编辑中设定的贴文主题、摘要或内容警告。
                example: warning nsfw
                type: string
                x-go-name: SpoilerText
        type: object
        x-go-name: StatusEdit
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    statusReblogged:
        properties:
            account:
                $ref: '#/definitions/account'
            application:
                $ref: '#/definitions/application'
            bookmarked:
                description: 此贴文已被查看它的账户收藏。
                type: boolean
                x-go-name: Bookmarked
            card:
                $ref: '#/definitions/card'
            content:
                description: 此贴文的内容。应为 HTML，但在某些情况下也可能为纯文本。
                example: <p>这是一条嘟文。</p>
                type: string
                x-go-name: Content
            content_type:
                description: |-
                    用于解析帖文文本的内容格式。
                    当帖文被删除时会返回该值，因此如果用户重新撰写消息，
                    客户端可以默认使用相同的内容格式。                    
                type: string
                x-go-name: ContentType
            created_at:
                description: 此贴文的创建时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            edited_at:
                description: 此贴文上次被编辑的时间 (ISO 8601 Datetime)。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: EditedAt
            emojis:
                description: 渲染此贴文时使用的自定义表情符号。
                items:
                    $ref: '#/definitions/emoji'
                type: array
                x-go-name: Emojis
            favourited:
                description: 此贴文已被查看它的账户点赞。
                type: boolean
                x-go-name: Favourited
            favourites_count:
                description: 此贴文收到的点赞数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: FavouritesCount
            filtered:
                description: 此贴文命中的过滤规则列表，如果有命中的过滤规则，还会包含命中原因。
                items:
                    $ref: '#/definitions/filterResult'
                type: array
                x-go-name: Filtered
            id:
                description: 贴文的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            in_reply_to_account_id:
                description: 贴文回复的账户的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToAccountID
            in_reply_to_id:
                description: 此贴文回复的贴文的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: InReplyToID
            interaction_policy:
                $ref: '#/definitions/interactionPolicy'
            language:
                description: |-
                    此贴文的主要语言 (ISO 639 Part 1 两字母语言代码)。
                    当语言未知时将为 null。                    
                example: zh
                type: string
                x-go-name: Language
            local_only:
                description: 若贴文不参与联合，则设置为 "true"；否则省略。
                type: boolean
                x-go-name: LocalOnly
            media_attachments:
                description: 随附到此贴文的媒体。
                items:
                    $ref: '#/definitions/attachment'
                type: array
                x-go-name: MediaAttachments
            mentions:
                description: 此贴文内容中提及的用户。
                items:
                    $ref: '#/definitions/Mention'
                type: array
                x-go-name: Mentions
            muted:
                description: 此贴文下的回复已被查看它的账户静音。
                type: boolean
                x-go-name: Muted
            pinned:
                description: 此贴文已被查看它的账户置顶（仅适用于您自己的贴文）。
                type: boolean
                x-go-name: Pinned
            poll:
                $ref: '#/definitions/poll'
            reblog:
                $ref: '#/definitions/statusReblogged'
            reblogged:
                description: 此贴文已被查看它的账户转发。
                type: boolean
                x-go-name: Reblogged
            reblogs_count:
                description: 此贴文被转发的次数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: ReblogsCount
            replies_count:
                description: 此贴文的回复数，数据来源于本站实例。
                format: int64
                type: integer
                x-go-name: RepliesCount
            sensitive:
                description: 贴文包含敏感内容。
                example: false
                type: boolean
                x-go-name: Sensitive
            spoiler_text:
                description: 此贴文的主题、摘要或内容警告。
                example: NSFW
                type: string
                x-go-name: SpoilerText
            tags:
                description: 此贴文内容中使用的话题标签。
                items:
                    $ref: '#/definitions/tag'
                type: array
                x-go-name: Tags
            text:
                description: |-
                    此贴文的纯文本内容。当贴文被删除时返回，以便用户可以从源文本重新起草，而无需客户端从 HTML 内容中逆向出原始文本。                    
                type: string
                x-go-name: Text
            uri:
                description: 此贴文的 ActivityPub URI。等同于贴文的 activitypub ID。
                example: https://example.org/users/some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URI
            url:
                description: 此贴文的公开 Web URL。仅当贴文的可见性为 'public' 时，此链接才有效。
                example: https://example.org/@some_user/statuses/01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: URL
            visibility:
                description: 此贴文的可见性。
                example: unlisted
                type: string
                x-go-name: Visibility
        title: StatusReblogged
        description: StatusReblogged 表示一条被转发的贴文。
        type: object
        x-go-name: StatusReblogged
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    statusSource:
        description: |-
            StatusSource 表示创建贴文时提交给 API 的贴文源文本。            
        properties:
            content_type:
                description: 用于解析贴文文本的内容格式。
                type: string
                x-go-name: ContentType
            id:
                description: 贴文的 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            spoiler_text:
                description: 贴文折叠提示的纯文本版本。
                type: string
                x-go-name: SpoilerText
            text:
                description: 贴文的源文本。
                type: string
                x-go-name: Text
        type: object
        x-go-name: StatusSource
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    swaggerCollection:
        properties:
            '@context':
                description: |-
                    ActivityStreams JSON-LD 上下文。
                    字符串或字符串数组，或更复杂的嵌套项。                    
                example: https://www.w3.org/ns/activitystreams
                x-go-name: Context
            first:
                $ref: '#/definitions/swaggerCollectionPage'
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies
                type: string
                x-go-name: ID
            last:
                $ref: '#/definitions/swaggerCollectionPage'
            type:
                description: ActivityStreams 类型。
                example: Collection
                type: string
                x-go-name: Type
        title: SwaggerCollection
        description: SwaggerCollection 表示一个 ActivityPub 集合。
        type: object
        x-go-name: SwaggerCollection
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/activitypub/users
    swaggerCollectionPage:
        properties:
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/statuses/106717595988259568/replies?page=true
                type: string
                x-go-name: ID
            items:
                description: 此页面上的条目。
                example:
                    - https://example.org/users/some_other_user/statuses/086417595981111564
                    - https://another.example.com/users/another_user/statuses/01FCN8XDV3YG7B4R42QA6YQZ9R
                items:
                    type: string
                type: array
                x-go-name: Items
            next:
                description: 指向下一页的链接。
                example: https://example.org/users/some_user/statuses/106717595988259568/replies?only_other_accounts=true&page=true
                type: string
                x-go-name: Next
            partOf:
                description: 此页面所属的集合。
                example: https://example.org/users/some_user/statuses/106717595988259568/replies
                type: string
                x-go-name: PartOf
            type:
                description: ActivityStreams 类型。
                example: CollectionPage
                type: string
                x-go-name: Type
        title: SwaggerCollectionPage
        description: SwaggerCollectionPage 表示一个 ActivityPub 集合的一页。
        type: object
        x-go-name: SwaggerCollectionPage
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/activitypub/users
    swaggerFeaturedCollection:
        properties:
            '@context':
                description: |-
                    ActivityStreams JSON-LD 上下文。
                    字符串或字符串数组，或更复杂的嵌套项。                    
                example: https://www.w3.org/ns/activitystreams
                x-go-name: Context
            TotalItems:
                description: 此集合中的项目数。
                example: 2
                format: int64
                type: integer
            id:
                description: ActivityStreams ID.
                example: https://example.org/users/some_user/collections/featured
                type: string
                x-go-name: ID
            items:
                description: 贴文 URI 的列表。
                example:
                    - https://example.org/users/some_user/statuses/01GSZ0F7Q8SJKNRF777GJD271R
                    - https://example.org/users/some_user/statuses/01GSZ0G012CBQ7TEKX689S3QRE
                items:
                    type: string
                type: array
                x-go-name: Items
            type:
                description: ActivityStreams 类型。
                example: OrderedCollection
                type: string
                x-go-name: Type
        title: SwaggerFeaturedCollection
        description: SwaggerFeaturedCollection 表示一个有序 ActivityPub 集合。
        type: object
        x-go-name: SwaggerFeaturedCollection
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/activitypub/users
    tag:
        properties:
            following:
                description: |-
                    Following 在当用户关注此标签时为 true，不关注时为 false，如果没有当前认证用户则省略。                    
                type: boolean
                x-go-name: Following
            history:
                description: |-
                    此话题标签的使用历史。
                    目前只是一个存根，如果提供将始终为空数组。                    
                example: []
                items: {}
                type: array
                x-go-name: History
            name:
                description: '此话题标签的名称，不包含 # 符号。'
                example: helloworld
                type: string
                x-go-name: Name
            url:
                description: 此话题标签的网页链接。
                example: https://example.org/tags/helloworld
                type: string
                x-go-name: URL
        title: Tag
        description: Tag 表示贴文内容中使用的某个话题标签。
        type: object
        x-go-name: Tag
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    theme:
        properties:
            description:
                description: 此主题面向用户的描述。
                type: string
                x-go-name: Description
            file_name:
                description: 此主题在主题目录中的文件名。
                type: string
                x-go-name: FileName
            title:
                description: 此主题的用户可见标题。
                type: string
                x-go-name: Title
        title: Theme
        description: Theme 表示一个用户可选的预设 CSS 主题。
        type: object
        x-go-name: Theme
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    threadContext:
        description: |-
            ThreadContext 是围绕给定贴文的贴文树/贴文串的抽象模型。            
        properties:
            ancestors:
                description: 此贴文的祖先。
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Ancestors
            descendants:
                description: 此贴文的后代。
                items:
                    $ref: '#/definitions/status'
                type: array
                x-go-name: Descendants
        type: object
        x-go-name: ThreadContext
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    tokenInfo:
        description: |-
            TokenInfo 表示与用户关联的访问令牌的元数据。
            实际的访问令牌将永远不会通过 API 发送。            
        properties:
            application:
                $ref: '#/definitions/application'
            created_at:
                description: 此令牌的创建时间（ISO 8601 Datetime）。
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            id:
                description: 此令牌的数据库 ID。
                example: 01JMW7QBAZYZ8T8H73PCEX12XG
                type: string
                x-go-name: ID
            last_used:
                description: |-
                    上一次使用此令牌的大致时间（精确到小时内，格式为 ISO 8601 Datetime）。
                    如果该令牌从未使用过，或者无法确定其上一次使用的时间（例如，在记录“last_used”之前就已使用过），则会省略此项。                    
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: LastUsed
            scope:
                description: 此令牌被授予的 OAuth 权限范围，以空格分隔。
                example: read write admin
                type: string
                x-go-name: Scope
        title: TokenInfo
        type: object
        x-go-name: TokenInfo
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    user:
        properties:
            admin:
                description: 用户为管理员。
                example: false
                type: boolean
                x-go-name: Admin
            approved:
                description: 用户已被管理员批准。
                example: true
                type: boolean
                x-go-name: Approved
            confirmation_sent_at:
                description: 上次发送“请确认您的电子邮件地址”电子邮件的时间（如果有的话）。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ConfirmationSentAt
            confirmed_at:
                description: 用户填写的电子邮件地址被确认的时间，如果有的话。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ConfirmedAt
            created_at:
                description: 用户创建时间。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: CreatedAt
            disabled:
                description: 用户的帐户已被停用。
                example: false
                type: boolean
                x-go-name: Disabled
            email:
                description: 用户确认的电子邮件地址（如果用户设置了电子邮件地址）。
                example: someone@example.org
                type: string
                x-go-name: Email
            id:
                description: 此用户的数据库 ID。
                example: 01FBVD42CQ3ZEEVMW180SBX03B
                type: string
                x-go-name: ID
            last_emailed_at:
                description: 上次给此用户发送电子邮件的时间，如果有的话。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: LastEmailedAt
            moderator:
                description: 用户为站务/监察员。
                example: false
                type: boolean
                x-go-name: Moderator
            reason:
                description: 用户注册原因（如果用户注册时填写了原因)。
                example: Please! Pretty please!
                type: string
                x-go-name: Reason
            reset_password_sent_at:
                description: 上次发送“请重置您的密码”电子邮件的时间（如果有的话）。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: ResetPasswordSentAt
            two_factor_enabled_at:
                description: 此用户启用双因素验证的时间。 (ISO 8601 Datetime)
                example: "2021-07-30T09:20:25+00:00"
                type: string
                x-go-name: TwoFactorEnabledAt
            unconfirmed_email:
                description: 此用户的未确认电子邮件地址（如果用户设置了电子邮件地址）。
                example: someone.else@somewhere.else.example.org
                type: string
                x-go-name: UnconfirmedEmail
        title: User
        description: User 是单个用户的相关字段的抽象模型。
        type: object
        x-go-name: User
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    webPushNotification:
        description: |-
            WebPushNotification 表示 Web 推送服务器传递给客户端的通知摘要。
            它不包含完整的通知，仅包含通知 ID 和一些预览信息。
            它并不直接用于客户端 API，而是包含在 API 文档中，用于解码 Web 推送通知。            
        properties:
            access_token:
                description: |-
                    AccessToken 是与 Web 推送订阅关联的访问令牌。
                    尚不清楚为何要发送此令牌，因为客户端理应已知晓，但 Feditext 确实使用了它。                    
                type: string
                x-go-name: AccessToken
            body:
                description: |-
                    Body 是通知正文的预览,
                    例如状态的内容警告或文本的第一行,
                    或帐户的简介的第一行。                    
                type: string
                x-go-name: Body
            icon:
                description: |-
                    Icon 是通知中显示的图像的 URL,
                    通常是帐户的头像。                    
                type: string
                x-go-name: Icon
            notification_id:
                description: NotificationID 是所引用的通知的 Notification.ID。
                type: string
                x-go-name: NotificationID
            notification_type:
                description: NotificationType 是所引用的通知的 Notification.Type。
                type: string
                x-go-name: NotificationType
            preferred_locale:
                description: PreferredLocale 是接收通知的用户的语言标签（BCP 47 标签）。
                type: string
                x-go-name: PreferredLocale
            title:
                description: |-
                    Title 是通知的标题,
                    通常是用户执行的动作的描述。                    
                type: string
                x-go-name: Title
        title: WebPushNotification
        type: object
        x-go-name: WebPushNotification
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    webPushSubscription:
        properties:
            alerts:
                $ref: '#/definitions/webPushSubscriptionAlerts'
            endpoint:
                description: 通知将被推送到的端点。
                type: string
                x-go-name: Endpoint
            id:
                description: 数据库中推送订阅的 ID。
                type: string
                x-go-name: ID
            policy:
                $ref: '#/definitions/WebPushNotificationPolicy'
            server_key:
                description: 此实例的 VAPID 公钥。
                type: string
                x-go-name: ServerKey
            standard:
                description: |-
                    是否使用 RFC 或预 RFC Web 推送标准。
                    对于 GotoSocial，这将总是为真。                    
                type: boolean
                x-go-name: Standard
        title: WebPushSubscription
        description: WebPushSubscription 表示对 Web 推送服务器的订阅。
        type: object
        x-go-name: WebPushSubscription
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    webPushSubscriptionAlerts:
        properties:
            admin.report:
                description: 是否在收到新的举报时接收推送通知？ 
                type: boolean
                x-go-name: AdminReport
            admin.sign_up:
                description: 是否在有新用户注册时接收推送通知？ 
                type: boolean
                x-go-name: AdminSignup
            favourite:
                description: 是否在某条贴文被其他人点赞时接收推送通知？
                type: boolean
                x-go-name: Favourite
            follow:
                description: 是否在有人关注你时接收推送通知？
                type: boolean
                x-go-name: Follow
            follow_request:
                description: 是否在有人向你发出关注请求时接收推送通知？
                type: boolean
                x-go-name: FollowRequest
            mention:
                description: 是否在有人在贴文中提及你时接收推送通知？ 
                type: boolean
                x-go-name: Mention
            pending.favourite:
                description: 是否在有点赞待处理时接收推送通知？ 
                type: boolean
                x-go-name: PendingFavourite
            pending.reblog:
                description: 是否在有转发待处理时接收推送通知？ 
                type: boolean
                x-go-name: PendingReblog
            pending.reply:
                description: 是否在有回复待处理时接收推送通知？ 
                type: boolean
                x-go-name: PendingReply
            poll:
                description: 是否在你参与或创建的投票结束时接收推送通知？
                type: boolean
                x-go-name: Poll
            reblog:
                description: 是否在你创建的贴文被别人转发时接收推送通知？
                type: boolean
                x-go-name: Reblog
            status:
                description: 是否在你订阅的某个账户发帖时接收推送通知？
                type: boolean
                x-go-name: Status
            update:
                description: 是否在你互动过的贴文被编辑时接收推送通知？
                type: boolean
                x-go-name: Update
        title: WebPushSubscriptionAlerts
        description: WebPushSubscriptionAlerts 代表此 Web 推送订阅将接收的具体事件。
        type: object
        x-go-name: WebPushSubscriptionAlerts
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
    wellKnownResponse:
        properties:
            aliases:
                items:
                    type: string
                type: array
                x-go-name: Aliases
            links:
                items:
                    $ref: '#/definitions/Link'
                type: array
                x-go-name: Links
            subject:
                type: string
                x-go-name: Subject
        title: WellKnownResponse
        description: |-
            WellKnownResponse 表示对“acct”资源的 webfinger 请求或对 nodeinfo 请求的响应。
            例如，访问 https://example.org/.well-known/webfinger?resource=acct:some_username@example.org 时将返回一个此类型的响应。
            参见 https://webfinger.net/            
        type: object
        x-go-name: WellKnownResponse
        x-go-package: code.superseriousbusiness.org/gotosocial/internal/api/model
host: example.org
info:
    contact:
        email: admin@gotosocial.org
        name: GotoSocial 开发者
    description: |-
        该文档描述了 GoToSocial HTTP API。

        有关如何使用 OAuth 访问令牌进行 API 身份验证的信息，请参阅此处的文档：https://docs.gotosocial.org/zh-cn/latest/api/authentication/。

        可用权限范围：

        admin: 授予对所有内容的管理权限
        admin:read: 授予对所有内容的管理读权限
        admin:read:accounts: 授予对账号的管理读权限
        admin:read:domain_allows: 授予对域名白名单的管理读权限
        admin:read:domain_blocks: 授予对域名黑名单的管理读权限
        admin:read:reports: 授予对举报的管理读权限
        admin:write: 授予对所有内容的管理写权限
        admin:write:accounts: 授予对账号的管理写权限
        admin:write:domain_allows: 授予对域名白名单的管理写权限
        admin:write:domain_blocks: 授予对域名黑名单的管理写权限
        admin:write:reports: 授予对举报的管理写权限
        profile: 授予对 verify_credentials 的读权限
        push: 授予对 push 的读写权限
        read: 授予对所有内容的读权限
        read:accounts: 授予对账号的读权限
        read:applications: 授予对用户管理的应用的读权限
        read:blocks: 授予对屏蔽的读权限
        read:bookmarks: 授予对收藏的读权限
        read:favourites: 授予对点赞的读权限
        read:filters: 授予对过滤规则的读权限
        read:follows: 授予对关注的读权限
        read:lists: 授予对列表的读权限
        read:mutes: 授予对隐藏的读权限
        read:notifications: 授予对通知的读权限
        read:search: 授予对搜索的读权限
        read:statuses: 授予对贴文的读权限
        write: 授予对所有内容的写权限
        write:accounts: 授予对账号的写权限
        write:applications: 授予对用户管理的应用的写权限
        write:blocks: 授予对屏蔽的写权限
        write:bookmarks: 授予对收藏的写权限
        write:conversations: 授予对对话的写权限
        write:favourites: 授予对点赞的写权限
        write:filters: 授予对过滤规则的写权限
        write:follows: 授予对关注的写权限
        write:lists: 授予对列表的写权限
        write:media: 授予对媒体的写权限
        write:mutes: 授予对隐藏的写权限
        write:notifications: 授予对通知的写权限
        write:reports: 授予对举报的写权限
        write:statuses: 授予对贴文的写权限        
    license:
        name: AGPL3
        url: https://www.gnu.org/licenses/agpl-3.0.zh-cn.html
    title: GoToSocial Swagger 文档
    version: 0.19.1-SNAPSHOT-6c879186
paths:
    /.well-known/host-meta:
        get:
            description: '响应 web 主机元数据查询，返回符合规范的 hostmeta 响应。参见: https://www.rfc-editor.org/rfc/rfc6415.html'
            operationId: hostMetaGet
            produces:
                - application/xrd+xml"
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/hostmeta'
            summary: 获取 host-meta
            tags:
                - .well-known
    /.well-known/nodeinfo:
        get:
            description: |-
                返回一个 well-known 响应，将调用者重定向到 `/nodeinfo/2.0`。
                例如: `{"links":[{"rel":"http://nodeinfo.diaspora.software/ns/schema/2.0","href":"http://example.org/nodeinfo/2.0"}]}`
                参见: https://nodeinfo.diaspora.software/protocol.html                
            operationId: nodeInfoWellKnownGet
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/wellKnownResponse'
            summary: 获取 nodeinfo
            tags:
                - .well-known
    /.well-known/webfinger:
        get:
            description: |-
                处理 webfinger 账户查询请求。
                例如，对 `https://example.org/.well-known/webfinger?resource=acct:admin@example.org` 发送 GET 请求，将返回：
                ```
                {"subject":"acct:admin@example.org","aliases":["https://example.org/users/admin","https://example.org/@admin"],"links":[{"rel":"http://webfinger.net/rel/profile-page","type":"text/html","href":"https://example.org/@admin"},{"rel":"self","type":"application/activity+json","href":"https://example.org/users/admin"}]}
                ```
                参见: https://webfinger.net/                
            operationId: webfingerGet
            produces:
                - application/jrd+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/wellKnownResponse'
            summary: Webfinger 账户查询
            tags:
                - .well-known
    /api/{api_version}/media:
        post:
            consumes:
                - multipart/form-data
            operationId: mediaCreate
            parameters:
                - description: 要使用的 API 版本。必须是 `v1` 或 `v2`。
                  in: path
                  name: api_version
                  required: true
                  type: string
                - description: 媒体附件的 alt 文本描述。这对于使用屏幕阅读器的用户非常有用！根据您的实例设置，可能需要也可能不需要。
                  in: formData
                  name: description
                  type: string
                - default: 0,0
                  description: '媒体附件的焦点。如果存在，它应该是两个介于 -1 和 1 之间的逗号分隔的浮点数。例如：`-0.5,0.25`。'
                  in: formData
                  name: focus
                  type: string
                - description: 要上传的媒体附件。
                  in: formData
                  name: file
                  required: true
                  type: file
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的媒体附件。
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "422":
                    description: unprocessable 无法处理
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:media
            summary: 上传新附件
            description: 上传新的媒体附件。
            tags:
                - media
    /api/{api_version}/search:
        get:
            description: 在本站或其他地方搜索贴文、帐户或话题标签。如果结果中包含贴文，则它们将按时间顺序（最新的在前）返回，带有连续的 ID（更大 = 更新）。
            operationId: searchGet
            parameters:
                - description: 必须是 `v1` 或 `v2`。如果使用 v1，Hashtag 结果将是字符串切片。如果使用 v2，Hashtag 结果将是 apimodel 标签切片。
                  in: path
                  name: api_version
                  required: true
                  type: string
                - description: 仅返回 *早于* 给定的 max ID 的项目。当前仅在将 type 设置为特定类型时使用。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回 *晚于且紧邻* 给定的 min ID 的项目。当前仅在将 type 设置为特定类型时使用。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的每种项目的数量。
                  in: query
                  maximum: 40
                  minimum: 1
                  name: limit
                  type: integer
                - default: 0
                  description: 要返回的结果的页数（从 0 开始）。该参数目前未使用，请通过选择特定的查询类型并使用 maxID 和 minID 来分页。
                  in: query
                  maximum: 10
                  minimum: 0
                  name: offset
                  type: integer
                - description: |-
                    要搜索的关键词。这可以是以下形式之一：
                    - `@[username]` -- 搜索任何实例上具有给定用户名的帐户。可以返回多个结果。
                    - `@[username]@[domain]` -- 精确匹配给定的用户名和实例域名的外站帐户。最多只会返回 1 个结果。
                    - `https://example.org/some/arbitrary/url` -- 搜索具有给定 URL 的账户或贴文。最多只会返回 1 个结果。
                    - `#[hashtag_name]` -- 搜索具有给定话题标签名称或以给定话题标签名称开头的话题标签。不区分大小写。可以返回多个结果。
                    - 任意字符串 -- 搜索包含给定字符串的帐户或贴文。可以返回多个结果。

                    任意字符串搜索可以包括以下运算符：
                    - `from:localuser`，`from:remoteuser@instance.tld`：将结果限制为由指定帐户创建的贴文。                    
                  in: query
                  name: q
                  required: true
                  type: string
                - description: |-
                    要返回的项目类型。可以是以下之一：
                    - `` -- 空字符串；返回任何/所有结果。
                    - `accounts` -- 仅返回帐户。
                    - `statuses` -- 仅返回贴文。
                    - `hashtags` -- 仅返回话题标签。
                    如果指定了 `type`，则可以使用 max_id 和 min_id 参数进行分页。
                    如果未指定 `type`，使用 `offset` 参数进行分页。                    
                  in: query
                  name: type
                  type: string
                - default: false
                  description: 若搜索关键词是 `@[username]@[domain]` 或 URL，则允许 GoToSocial 实例通过外站调用（webfinger、ActivityPub 等）来解析搜索关键词。
                  in: query
                  name: resolve
                  type: boolean
                - default: false
                  description: 若搜索类型包括帐户，并且搜索关键词是任意字符串，则仅显示请求帐户关注的帐户。如果设置为 `true`，则 GoToSocial 将在用户名和昵称之外同时检索账户信息来增强搜索。
                  in: query
                  name: following
                  type: boolean
                - default: false
                  description: 若搜索类型包括话题标签，并且搜索关键词是任意字符串，则排除尚未被实例管理员批准的话题标签。目前此参数未使用。
                  in: query
                  name: exclude_unreviewed
                  type: boolean
                - description: 将搜索范围限制到由指定帐户创建的贴文。
                  in: query
                  name: account_id
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 搜索结果。
                    schema:
                        $ref: '#/definitions/searchResult'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:search
            summary: 搜索
            tags:
                - search
    /api/v1/accounts:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                使用应用程序令牌创建新帐户。
                若 Content-Type 为 `application/json`，则参数也可在请求体中以 JSON 形式给出。
                若 Content-Type 为 `application/xml`，则参数也可在请求体中以 XML 形式给出。                
            operationId: accountCreate
            parameters:
                - description: 若注册需要手动批准，则此文本将由管理员审核。
                  in: query
                  name: reason
                  type: string
                  x-go-name: Reason
                - description: 账户设置的用户名。
                  in: query
                  name: username
                  type: string
                  x-go-name: Username
                - description: 用于登录的电子邮件地址。
                  in: query
                  name: email
                  type: string
                  x-go-name: Email
                - description: 用于登录的密码。将在存储之前进行哈希处理。
                  in: query
                  name: password
                  type: string
                  x-go-name: Password
                - description: 用户同意实例的条款、条件和政策。
                  in: query
                  name: agreement
                  type: boolean
                  x-go-name: Agreement
                - description: 确认邮件的语言。
                  in: query
                  name: locale
                  type: string
                  x-go-name: Locale
            produces:
                - application/json
            responses:
                "200":
                    description: 为新创建的帐户提供的 OAuth2 访问令牌。
                    schema:
                        $ref: '#/definitions/oauthToken'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理. 你的帐户创建请求无法处理，因为在过去的 24 小时内在此实例上创建了太多帐户，或者待处理的帐户积压已满。
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Application:
                    - write:accounts
            summary: 创建新帐户
            tags:
                - accounts
    /api/v1/accounts/{id}:
        get:
            operationId: accountGet
            parameters:
                - description: 请求的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的帐户。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取账户详情
            description: 获取具有给定 ID 的帐户的信息。
            tags:
                - accounts
    /api/v1/accounts/{id}/block:
        post:
            operationId: accountBlock
            parameters:
                - description: 要屏蔽的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与帐户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:blocks
            summary: 屏蔽帐户
            description: 屏蔽具有给定 ID 的帐户。
            tags:
                - accounts
    /api/v1/accounts/{id}/featured_tags:
        get:
            operationId: accountsFeaturedTags
            parameters:
                - description: 目标账户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            type: object
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取账户精选话题标签
            description: 以数组的形式获取目标帐户的精选话题标签。此端点目前尚未完全实现：它将始终返回一个空数组。
            tags:
                - accounts
    /api/v1/accounts/{id}/follow:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                关注具有给定 ID 的帐户。

                若 Content-Type 为 `application/json`，则参数也可在请求体中以 JSON 形式给出。
                若 Content-Type 为 `application/xml`，则参数也可在请求体中以 XML 形式给出。

                若您已经关注了给定的帐户，则关注(请求)将被更新，不会使用 `reblogs` 和 `notify` 参数。                
            operationId: accountFollow
            parameters:
                - description: 要关注的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: true
                  description: 显示此帐户的转发。
                  in: formData
                  name: reblogs
                  type: boolean
                - default: false
                  description: 该账户发帖时通知。
                  in: formData
                  name: notify
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此帐户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 关注帐户
            tags:
                - accounts
    /api/v1/accounts/{id}/followers:
        get:
            description: |-
                查看关注此帐户的帐户。
                下一个/上一个查询可以从返回的 Link 标头中解析。
                例如：

                ```
                <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/followers?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/followers?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ```
                若帐户 `hide_collections` 为 true，且请求帐户 != 目标帐户，则不会返回结果。                
            operationId: accountFollowers
            parameters:
                - description: 帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: '仅返回早于给定的max ID 的粉丝帐户。具有指定 ID 的粉丝帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回晚于给定的 since ID 的粉丝帐户。具有指定 ID 的粉丝帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回 *晚于且紧邻* 给定的 min ID 的粉丝帐户。具有指定 ID 的粉丝帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的粉丝帐户数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 一个关注此帐户的帐户的数组。
                    headers:
                        Link:
                            description: 指向下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看粉丝
            tags:
                - accounts
    /api/v1/accounts/{id}/following:
        get:
            description: |-
                查询此ID对应的帐户关注的帐户。
                下一个/上一个查询可以从返回的 Link 标头中解析。
                示例:
                ```
                <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/following?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/accounts/0657WMDEC3KQDTD6NZ4XJZBK4M/following?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ```
                若帐户 `hide_collections` 为 true，且请求帐户 != 目标帐户，则不会返回结果。                
            operationId: accountFollowing
            parameters:
                - description: Account ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: '仅返回早于给定的 max ID 的关注帐户。具有指定 ID 的关注帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回晚于给定的 since ID 的关注帐户。具有指定 ID 的关注帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回 *晚于且紧邻* 给定的 min ID 的关注帐户。具有指定 ID 的关注帐户不会包含在响应中。注意：ID 是内部关注的 ID，而不是任何返回的帐户的 ID。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的关注帐户数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 此账户关注的账户数组。
                    headers:
                        Link:
                            description: 指向下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看关注
            tags:
                - accounts
    /api/v1/accounts/{id}/lists:
        get:
            operationId: accountLists
            parameters:
                - description: 账户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 一个包含此帐户的所有列表的数组。
                    schema:
                        items:
                            $ref: '#/definitions/list'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 查看列表
            description: 查看你的列表中包含此帐户的所有列表。
            tags:
                - accounts
    /api/v1/accounts/{id}/mute:
        post:
            description: 根据 ID 静音/隐藏帐户。若此账户已被静音/隐藏，则无论如何都会成功。这可以用来更新静音/隐藏的细节。
            operationId: accountMute
            parameters:
                - description: 要静音/隐藏的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: false
                  description: 在静音/隐藏贴文的同时也静音/隐藏通知。
                  in: formData
                  name: notifications
                  type: boolean
                - default: 0
                  description: 静音/隐藏持续时间，以秒为单位。如果为 0 或未提供，则静音/隐藏持续时间无限。
                  in: formData
                  name: duration
                  type: number
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此帐户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户设置静音/隐藏
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: 静音/隐藏帐户
            tags:
                - accounts
    /api/v1/accounts/{id}/note:
        post:
            consumes:
                - multipart/form-data
            operationId: accountNote
            parameters:
                - description: 备注要添加到的帐户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: ""
                  description: 备注的文本。省略此参数或发送空字符串以清除备注。
                  in: formData
                  name: comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 设置备注
            description: 为具有给定 ID 的帐户设置私人备注。
            tags:
                - accounts
    /api/v1/accounts/{id}/statuses:
        get:
            description: 查看指定账户的贴文。贴文将按时间顺序（最新的在前）返回，带有连续的 ID（更大 = 更新）。
            operationId: accountStatuses
            parameters:
                - description: 账户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: 30
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: 排除回复。
                  in: query
                  name: exclude_replies
                  type: boolean
                - default: false
                  description: 排除转发。
                  in: query
                  name: exclude_reblogs
                  type: boolean
                - description: 仅返回 *早于* 给定的 max status ID 的项目。当前仅在将 type 设置为特定类型时使用。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回 *晚于* 给定的 min status ID 的项目。当前仅在将 type 设置为特定类型时使用。
                  in: query
                  name: min_id
                  type: string
                - default: false
                  description: 仅显示置顶的贴文。即排除未置顶到给定帐户 ID 的贴文。
                  in: query
                  name: pinned
                  type: boolean
                - default: false
                  description: 仅显示带有媒体附件的贴文。
                  in: query
                  name: only_media
                  type: boolean
                - default: false
                  description: 仅显示具有“公开”可见性的贴文。
                  in: query
                  name: only_public
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文的数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看贴文
            tags:
                - accounts
    /api/v1/accounts/{id}/unblock:
        post:
            operationId: accountUnblock
            parameters:
                - description: 要解除屏蔽的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:blocks
            summary: 解除屏蔽账户
            description: 解除对给定 ID 的帐户的屏蔽。
            tags:
                - accounts
    /api/v1/accounts/{id}/unfollow:
        post:
            operationId: accountUnfollow
            parameters:
                - description: 要取消关注的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 取关账户
            description: 取消关注具有给定 ID 的帐户。
            tags:
                - accounts
    /api/v1/accounts/{id}/unmute:
        post:
            description: 解除对给定 ID 的帐户的静音/隐藏。若账户已被解除静音/隐藏，则无论如何都会成功。
            operationId: accountUnmute
            parameters:
                - description: 要解除静音/隐藏的帐户 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: 取消静音/隐藏账户
            tags:
                - accounts
    /api/v1/accounts/alias:
        post:
            consumes:
                - multipart/form-data
            description: |-
                通过将 alsoKnownAs 设置为给定的 URI，将此账户设置为另一个账户的别名。

                在需要将其它账户迁移到此账户时很有用。

                在这种情况下，你应该将此账户的 alsoKnownAs 设置为要发起迁移的账户的 URI。                
            operationId: accountAlias
            parameters:
                - description: |-
                    要设为别名的账户的 ActivityPub URI/ID。例如，`["https://example.org/users/some_account"]`。
                    使用空数组也可以清除 alsoKnownAs，清除账户别名。                    
                  in: formData
                  name: also_known_as_uris
                  required: true
                  type: string
            responses:
                "200":
                    description: 更新后的账户。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理。请查看响应正文以获取更多详细信息。
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 设置账户别名
            tags:
                - accounts
    /api/v1/accounts/delete:
        post:
            consumes:
                - multipart/form-data
            operationId: accountDelete
            parameters:
                - description: 账户的密码，用于确认。
                  in: formData
                  name: password
                  required: true
                  type: string
            responses:
                "202":
                    description: 账户删除请求已被接受，账户将被删除。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 删除账户
            tags:
                - accounts
    /api/v1/accounts/lookup:
        get:
            operationId: accountLookupGet
            parameters:
                - description: 要查询的用户名或 Webfinger 地址。
                  in: query
                  name: acct
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 查询结果。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 快速查找账户
            description: 快速查找用户名以查看其是否可用，跳过 WebFinger 解析。
            tags:
                - accounts
    /api/v1/accounts/move:
        post:
            consumes:
                - multipart/form-data
            operationId: accountMove
            parameters:
                - description: 账户的密码，用于确认。
                  in: formData
                  name: password
                  required: true
                  type: string
                - description: 目标账户的 ActivityPub URI/ID。例如，`https://example.org/users/some_account`。目标账户必须也是请求账户的 alsoKnownAs，才能成功迁移。
                  in: formData
                  name: moved_to_uri
                  required: true
                  type: string
            responses:
                "202":
                    description: 账户迁移请求已被接受，账户将被迁移。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理。请查看响应正文以获取更多详细信息。
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 迁出账户
            description: 将此账户迁移到另一个账户。
            tags:
                - accounts
    /api/v1/accounts/relationships:
        get:
            operationId: accountRelationships
            parameters:
                - collectionFormat: multi
                  description: 账户 ID。
                  in: query
                  items:
                    type: string
                  name: id[]
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 账户关系(relationship)的数组。
                    schema:
                        items:
                            $ref: '#/definitions/accountRelationship'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查询账户关系
            description: 查看你的账户与给定账户 ID 的关系。
            tags:
                - accounts
    /api/v1/accounts/search:
        get:
            operationId: accountSearchGet
            parameters:
                - default: 40
                  description: 要返回的结果数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
                - default: 0
                  description: 要返回的结果所在的页数（从 0 开始）。此参数目前未使用，偏移量大于 0 将始终返回 0 个结果。
                  in: query
                  maximum: 10
                  minimum: 0
                  name: offset
                  type: integer
                - description: |-
                    要查找的关键词。可以是以下形式之一：
                    - `@[username]` -- 在任何实例上搜索具有给定用户名的帐户。可以返回多个结果。
                    - `@[username]@[domain]` -- 搜索确切的用户名和域名的外站帐户。最多只返回 1 个结果。
                    - 任意字符串 -- 搜索用户名或昵称中包含给定字符串的帐户。可以返回多个结果。                    
                  in: query
                  name: q
                  required: true
                  type: string
                - default: false
                  description: 若关键词为 `@[username]@[domain]` 或 URL，允许 GoToSocial 实例通过调用外站实例（webfinger、ActivityPub 等）来解析搜索。
                  in: query
                  name: resolve
                  type: boolean
                - default: false
                  description: 只显示发起请求的账户关注的账户。如果设置为 `true`，则 GoToSocial 实例将在用户名和昵称之外，同时在账户信息中发起搜索，来增强搜索结果。
                  in: query
                  name: following
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 搜索结果。
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 搜索账户
            description: 搜索具有给定用户名或昵称的帐户。
            tags:
                - accounts
    /api/v1/accounts/themes:
        get:
            operationId: accountThemes
            produces:
                - application/json
            responses:
                "200":
                    description: 主题的数组。
                    schema:
                        items:
                            $ref: '#/definitions/theme'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看主题
            description: 查看此实例上可用于账户的预设 CSS 主题。
            tags:
                - accounts
    /api/v1/accounts/update_credentials:
        patch:
            consumes:
                - multipart/form-data
                - application/x-www-form-urlencoded
                - application/json
            operationId: accountUpdate
            parameters:
                - description: 账户是否可被发现，并在用户名录中显示。
                  in: formData
                  name: discoverable
                  type: boolean
                - description: 账户被标记为机器人。
                  in: formData
                  name: bot
                  type: boolean
                - allowEmptyValue: true
                  description: 账户的昵称。
                  in: formData
                  name: display_name
                  type: string
                - allowEmptyValue: true
                  description: 账户的简介。
                  in: formData
                  name: note
                  type: string
                - description: 账户的头像。
                  in: formData
                  name: avatar
                  type: file
                - allowEmptyValue: true
                  description: 账户的头像描述，用于 alt 文本。
                  in: formData
                  name: avatar_description
                  type: string
                - description: 用户的资料页横幅背景。
                  in: formData
                  name: header
                  type: file
                - allowEmptyValue: true
                  description: 用户资料页横幅背景的描述，用于 alt 文本。
                  in: formData
                  name: header_description
                  type: string
                - description: 关注请求需要手动批准。
                  in: formData
                  name: locked
                  type: boolean
                - description: 撰写的贴文的默认可见性。
                  in: formData
                  name: source[privacy]
                  type: string
                - description: 将撰写的贴文默认标记为敏感。
                  in: formData
                  name: source[sensitive]
                  type: boolean
                - description: 撰写的贴文的默认语言 (ISO 6391)。
                  in: formData
                  name: source[language]
                  type: string
                - description: 撰写的贴文的默认内容类型 (text/plain 或 text/markdown)。
                  in: formData
                  name: source[status_content_type]
                  type: string
                - description: 渲染此帐户的资料页或贴文时要使用的主题的文件名。主题必须存在于此服务器上，如 /api/v1/accounts/themes 所示。空字符串意味着取消主题偏好并回退到 GoToSocial 默认主题。
                  in: formData
                  name: theme
                  type: string
                - description: 渲染此帐户的资料页或贴文时要使用的自定义 CSS。字符串长度不能超过 5,000 个字符（~5kb）。
                  in: formData
                  name: custom_css
                  type: string
                - description: 为此帐户的公开贴文启用 RSS 订阅，端点为 `/[username]/feed.rss`。
                  in: formData
                  name: enable_rss
                  type: boolean
                - description: 隐藏此帐户的关注/粉丝信息。
                  in: formData
                  name: hide_collections
                  type: boolean
                - description: |-
                    Posts to show on the web view of the account.
                    "public": default, show only Public visibility posts on the web.
                    "unlisted": show Public *和* Unlisted visibility posts on the web.
                    "none": show no posts on the web, not even Public ones.
                    要在网页端展示的贴文范围。
                    "public": 默认，只在网页上显示公开的贴文。
                    "unlisted": 在网页上显示可见性为公开 *和* 不列出的贴文。
                    "none": 在网页上不显示任何贴文，甚至不显示公开的贴文。                    
                  in: formData
                  name: web_visibility
                  type: string
                - description: |-
                    此账户使用的网页布局。
                    "microblog": 默认，经典的微博客布局。
                    "gallery": 仅显示媒体的画廊布局。                    
                  in: formData
                  name: web_layout
                  type: string
                - description: 要添加到此帐户的资料页的第一个资料字段的名称。 （索引可以是任何字符串；添加更多索引以发送更多字段。）
                  in: formData
                  name: fields_attributes[0][name]
                  type: string
                - description: 要添加到此帐户的资料页的第一个资料字段的值。 （索引可以是任何字符串；添加更多索引以发送更多字段。）
                  in: formData
                  name: fields_attributes[0][value]
                  type: string
                - description: 要添加到此帐户的资料页的第二个资料字段的名称。
                  in: formData
                  name: fields_attributes[1][name]
                  type: string
                - description: 要添加到此帐户的资料页的第二个资料字段的值。
                  in: formData
                  name: fields_attributes[1][value]
                  type: string
                - description: 要添加到此帐户的资料页的第三个资料字段的名称。
                  in: formData
                  name: fields_attributes[2][name]
                  type: string
                - description: 要添加到此帐户的资料页的第三个资料字段的值。
                  in: formData
                  name: fields_attributes[2][value]
                  type: string
                - description: 要添加到此帐户的资料页的第四个资料字段的名称。
                  in: formData
                  name: fields_attributes[3][name]
                  type: string
                - description: 要添加到此帐户的资料页的第四个资料字段的值。
                  in: formData
                  name: fields_attributes[3][value]
                  type: string
                - description: 要添加到此帐户的资料页的第五个资料字段的名称。
                  in: formData
                  name: fields_attributes[4][name]
                  type: string
                - description: 要添加到此帐户的资料页的第五个资料字段的值。
                  in: formData
                  name: fields_attributes[4][value]
                  type: string
                - description: 要添加到此帐户的资料页的第六个资料字段的名称。
                  in: formData
                  name: fields_attributes[5][name]
                  type: string
                - description: 要添加到此帐户的资料页的第六个资料字段的值。
                  in: formData
                  name: fields_attributes[5][value]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的账户。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 更新账户信息
            description: 更新你的账户信息。
            tags:
                - accounts
    /api/v1/accounts/verify_credentials:
        get:
            operationId: accountVerify
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 验证令牌
            description: 验证令牌并返回与之相关的账户详细信息。
            tags:
                - accounts
    /api/v1/admin/accounts:
        get:
            description: |-
                使用特定的过滤规则查看 + 分页浏览已知的账户。

                返回的账户将按域名 + 用户名的字母顺序（a-z）排序。

                下一个和上一个查询可以从返回的 Link 标头中解析出来。
                例如：

                ```
                <https://example.org/api/v1/admin/accounts?limit=80&max_id=example.org%2F%40someone>; rel="next", <https://example.org/api/v1/admin/accounts?limit=80&min_id=example.org%2F%40someone_else>; rel="prev"
                ````                
            operationId: adminAccountsGetV1
            parameters:
                - default: false
                  description: 只显示本站账户的过滤规则。
                  in: query
                  name: local
                  type: boolean
                - default: false
                  description: 只显示外站账户的过滤规则。
                  in: query
                  name: remote
                  type: boolean
                - default: false
                  description: 只显示当前活跃的账户的过滤规则。
                  in: query
                  name: active
                  type: boolean
                - default: false
                  description: 只显示当前待处理的账户的过滤规则。
                  in: query
                  name: pending
                  type: boolean
                - default: false
                  description: 只显示当前被禁用的账户的过滤规则。
                  in: query
                  name: disabled
                  type: boolean
                - default: false
                  description: 只显示当前被静音的账户的过滤规则。
                  in: query
                  name: silenced
                  type: boolean
                - default: false
                  description: 只显示当前被封禁的账户的过滤规则。
                  in: query
                  name: suspended
                  type: boolean
                - default: false
                  description: 只显示当前被强制标记为敏感的账户的过滤规则。
                  in: query
                  name: sensitized
                  type: boolean
                - description: 搜索给定的用户名。
                  in: query
                  name: username
                  type: string
                - description: 搜索给定的昵称。
                  in: query
                  name: display_name
                  type: string
                - description: 搜索给定的域名。
                  in: query
                  name: by_domain
                  type: string
                - description: 搜索具有给定电子邮箱的用户。
                  in: query
                  name: email
                  type: string
                - description: 搜索具有给定 IP 地址的用户。
                  in: query
                  name: ip
                  type: string
                - default: false
                  description: 搜索工作人员账户。
                  in: query
                  name: staff
                  type: boolean
                - description: "`[domain]/@[username]` 中的 `max_id`。返回的所有结果都将在 `[domain]/@[username]` 之后的字母顺序中。例如，如果 `max_id` = `example.org/@someone`，则返回的条目可能包含 `example.org/@someone_else`、`later.example.org/@someone` 等。在此形式中，本站帐户 ID 使用空字符串作为 `[domain]` 部分，例如具有用户名 `someone` 的本地帐户将是 `/@someone`。"
                  in: query
                  name: max_id
                  type: string
                - description: "`[domain]/@[username]` 中的 `min_id`。返回的所有结果都将在 `[domain]/@[username]` 之前的字母顺序中。例如，如果 `min_id` = `example.org/@someone`，则返回的条目可能包含 `example.org/@earlier_account`、`earlier.example.org/@someone` 等。在此形式中，本站帐户 ID 使用空字符串作为 `[domain]` 部分，例如具有用户名 `someone` 的本地帐户将是 `/@someone`。"
                  in: query
                  name: min_id
                  type: string
                - default: 50
                  description: 要返回的最大结果数。
                  in: query
                  maximum: 200
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/adminAccountInfo'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:accounts
            summary: 查看账户
            tags:
                - admin
    /api/v1/admin/accounts/{id}:
        get:
            operationId: adminAccountGet
            parameters:
                - description: 账户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: OK
                    schema:
                        $ref: '#/definitions/adminAccountInfo'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:accounts
            summary: 查看单个账户
            description: 查看一个账户。
            tags:
                - admin
    /api/v1/admin/accounts/{id}/action:
        post:
            consumes:
                - multipart/form-data
            operationId: adminAccountAction
            parameters:
                - description: 账户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 要执行的操作类型，目前仅支持 `suspend`。
                  in: formData
                  name: type
                  required: true
                  type: string
                - description: 描述执行此操作的原因的文本，可不填。
                  in: formData
                  name: text
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: OK
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:accounts
            summary: 执行管理操作
            description: 对某个账户执行管理员操作。
            tags:
                - admin
    /api/v1/admin/accounts/{id}/approve:
        post:
            operationId: adminAccountApprove
            parameters:
                - description: 账户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被批准后的账户。
                    schema:
                        $ref: '#/definitions/adminAccountInfo'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:accounts
            summary: 批准账户
            description: 批准待处理的账户。
            tags:
                - admin
    /api/v1/admin/accounts/{id}/reject:
        post:
            operationId: adminAccountReject
            parameters:
                - description: 账户的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 用于说明为什么拒绝此账户的评论。评论仅对管理员可见。
                  in: formData
                  name: private_comment
                  type: string
                - description: 要包含在发送给申请人的电子邮件中的消息。仅在 send_email 为 true 时包含。
                  in: formData
                  name: message
                  type: string
                - description: 向申请人发送一封电子邮件，告知他们的注册已被拒绝。
                  in: formData
                  name: send_email
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 被拒绝的账户。
                    schema:
                        $ref: '#/definitions/adminAccountInfo'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:accounts
            summary: 拒绝账户
            description: 拒绝待处理的账户。
            tags:
                - admin
    /api/v1/admin/custom_emojis:
        get:
            description: |-
                下一个/上一个查询可以从返回的 Link 标头中解析。
                例如：

                `<http://localhost:8080/api/v1/admin/custom_emojis?limit=30&max_shortcode_domain=yell@fossbros-anonymous.io&filter=domain:all>; rel="next", <http://localhost:8080/api/v1/admin/custom_emojis?limit=30&min_shortcode_domain=rainbow@&filter=domain:all>; rel="prev"`                
            operationId: emojisGet
            parameters:
                - default: domain:all
                  description: |-
                    查看本站表情和已知的外站表情。

                    要应用到结果中的过滤规则列表，以逗号分隔。可被识别的过滤规则有：

                    `domain:[domain]` -- 显示给定域名下的表情，例如 `?filter=domain:example.org` 将只显示 `example.org` 的表情。
                    除了给定特定域名外，还可以给出关键字 `local` 或 `all`，以仅显示本站表情 (`domain:local`) 或显示所有实例的所有表情 (`domain:all`)。
                    注意：`domain:*` 等同于 `domain:all`（包括本站）。
                    如果未提供域名过滤规则，则将假定 `domain:all`。

                    `disabled` -- 包括已禁用的表情。

                    `enabled` -- 包括已启用的表情。

                    `shortcode:[shortcode]` -- 仅显示给定的表情代码，例如 `?filter=shortcode:blob_cat_uwu` 将仅显示表情代码为 `blob_cat_uwu` 的表情（区分大小写）。

                    如果未提供 `disabled` 或 `enabled`，则将同时显示已禁用和已启用的表情。

                    如果未提供过滤规则，则将使用默认的 `domain:all`，它将显示所有实例的所有表情。                    
                  in: query
                  name: filter
                  type: string
                - default: 50
                  description: 要返回的表情数量。小于 1 或未设置表示无限制（所有表情）。
                  in: query
                  maximum: 200
                  minimum: 0
                  name: limit
                  type: integer
                - description: |-
                    只返回比给定 `[shortcode]@[domain]` *更低*（按字母顺序）的表情。例如，如果 `max_shortcode_domain=beep@example.org`，则返回的值可能包括 `[shortcode]@[domain]` 为 `car@example.org`, `debian@aaa.com`, `test@` (本站表情) 等。
                    具有给定 `[shortcode]@[domain]` 的表情将不包含在结果集中。                    
                  in: query
                  name: max_shortcode_domain
                  type: string
                - description: |-
                    只返回比给定 `[shortcode]@[domain]` *更高*（按字母顺序）的表情。例如，如果 `max_shortcode_domain=beep@example.org`, 则返回的值可能包括 `[shortcode]@[domain]` 为 `arse@test.com`, `0101_binary@hackers.net`, `bee@` (本站表情) 等。
                    具有给定 `[shortcode]@[domain]` 的表情将不包含在结果集中。                    
                  in: query
                  name: min_shortcode_domain
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 表情数组，按表情代码和域名字母顺序排列。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/adminEmoji'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看表情
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            operationId: emojiCreate
            parameters:
                - description: 此表情的代码，将被实例居民用于选定对应表情。此代码在实例上必须是唯一的。
                  in: formData
                  name: shortcode
                  pattern: \w{1,30}
                  required: true
                  type: string
                - description: 此表情的 png 或 gif 图像。动画 png 也可以！为了确保与其他 fedi 实现的兼容性，默认情况下表情大小限制为 50kb。
                  in: formData
                  name: image
                  required: true
                  type: file
                - description: 此表情所属的类别。如果留空，表情将不属于任何类别。如果给定的类别名称尚不存在，则将创建该类别。
                  in: formData
                  name: category
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的表情。
                    schema:
                        $ref: '#/definitions/emoji'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: 冲突 -- 此表情的代码已被使用
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 创建表情
            description: 上传和创建一个新的实例表情。
            tags:
                - admin
    /api/v1/admin/custom_emojis/{id}:
        delete:
            description: |-
                在此实例删除一个 **本地** 表情。

                给定 ID 的表情将不再在此实例上可用。

                如果您只想更新表情图像，请使用 `/api/v1/admin/custom_emojis/{id}` PATCH 路由。

                要禁用 **外站** 实例的表情，请使用 `/api/v1/admin/custom_emojis/{id}` PATCH 路由。                
            operationId: emojiDelete
            parameters:
                - description: 表情的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被删除的表情将被返回给调用者，以便进一步处理。
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 删除表情
            tags:
                - admin
        get:
            operationId: emojiGet
            parameters:
                - description: 表情的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 单个表情。
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看表情
            description: 在管理视图中查看单个表情。
            tags:
                - admin
        patch:
            consumes:
                - multipart/form-data
            description: |-
                对一个 **本站** 或 **外站** 表情执行管理操作。

                要执行的操作取决于提供的操作类型 `type` 参数。

                `disable`: 禁用一个 **外站** 表情，使其无法在此实例上使用/显示。不适用于本站表情。

                `copy`: 将 **外站** 表情复制到此实例。执行此操作时，必须提供一个表情代码，并且它必须在此实例上已有的表情中是唯一的。可以提供一个类别，然后复制的表情将被放入提供的类别中。

                `modify`: 修改一个 **本站** 表情。您可以为表情提供一个新的图像和/或更新类别。

                本站表情不能使用此端点删除。要删除本站表情，请查看 DELETE /api/v1/admin/custom_emojis/{id}。                
            operationId: emojiUpdate
            parameters:
                - description: 表情的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    要执行的操作类型。需为下列其中之一：(`disable`, `copy`, `modify`)。
                    对于 **外站** 表情，支持 `copy` 或 `disable`。
                    对于 **本站** 表情，仅支持 `modify`。                    
                  enum:
                    - copy
                    - disable
                    - modify
                  in: formData
                  name: type
                  required: true
                  type: string
                - description: 用于表情的代码，将被实例居民用于选定表情。此代码在实例上必须是唯一的。仅适用于 `copy` 操作类型。
                  in: formData
                  name: shortcode
                  pattern: \w{1,30}
                  type: string
                - description: 此表情的新 png 或 gif 图像。动画 png 也可以！为了确保与其他 fedi 实现的兼容性，默认情况下表情大小限制为 50kb。仅适用于 **本站** 表情。
                  in: formData
                  name: image
                  type: file
                - description: 表情所属的类别。如果尚不存在具有给定名称的类别，则将创建该类别。仅适用于 `copy` 和 `modify` 操作类型。
                  in: formData
                  name: category
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的表情。
                    schema:
                        $ref: '#/definitions/adminEmoji'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 修改表情
            tags:
                - admin
    /api/v1/admin/custom_emojis/categories:
        get:
            operationId: emojiCategoriesGet
            produces:
                - application/json
            responses:
                "200":
                    description: 现有表情类别的数组。
                    schema:
                        items:
                            $ref: '#/definitions/emojiCategory'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看表情类别
            description: 获取现有表情类别的列表。
            tags:
                - admin
    /api/v1/admin/debug/apurl:
        get:
            description: 对指定的 ActivityPub URL 执行 GET 请求，并返回详细的调试信息。仅当 GoToSocial 使用 DEBUG=1 标志构建和运行时才启用/公开。
            operationId: debugAPUrl
            parameters:
                - description: 要解析的 URL 或 ActivityPub ID。 如 `https://example.org/users/someone`
                  in: query
                  name: url
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/debugAPUrlResponse'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 解析 ActivityPub URL
            tags:
                - debug
    /api/v1/admin/debug/caches/clear:
        post:
            description: 清除所有内存中的缓存。仅当 GoToSocial 使用 DEBUG=1 标志构建和运行时才启用/公开。
            operationId: debugClearCaches
            produces:
                - application/json
            responses:
                "200":
                    description: 所有缓存都已清除。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 清除缓存
            tags:
                - debug
    /api/v1/admin/domain_allows:
        get:
            operationId: domainAllowsGet
            parameters:
                - description: 如果设为 `true`，则返回的实例白名单列表中的每个条目将仅包含字段 `domain` 和 `public_comment`。这对于当您想要保存和共享您实例上允许的所有域名的列表时非常有用，以便其他人可以轻松导入它们，但您不希望他们看到您的允许的数据库 ID，或私人评论等。
                  in: query
                  name: export
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 目前所有被允许的域名。
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:domain_allows
            summary: 查看实例白名单
            description: 查看当前所有被允许联合的域名。
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            description: |-
                从字符串或文件中创建一个或多个实例白名单。

                在使用此端点时，您有两个选项：要么将 `import` 设置为 `true` 并上传一个包含多个要允许的域名的 JSON 文件，要么将 `import` 设置为 `false`，并添加一条要允许的域名。

                JSON 文件的格式应该类似于：`[{"domain":"example.org"},{"domain":"whatever.com","public_comment":"它们是我的好厚米"}]`                
            operationId: domainAllowCreate
            parameters:
                - default: false
                  description: 表示正在导入一个包含多个要允许的域名的文件。如果设置为 `true`，则 `domains` 必须作为 JSON 格式的文件存在。如果设置为 `false`，则 `domains` 将被忽略，`domain` 必须存在。
                  in: query
                  name: import
                  type: boolean
                - description: JSON 格式的实例白名单列表。仅在 `import` 设置为 `true` 时使用。
                  in: formData
                  name: domains
                  type: file
                - description: 要允许的单个域名。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: domain
                  type: string
                - description: 在公开时对域名的名称进行混淆。例如，`example.org` 变成类似于 `ex***e.org`。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: 有关此实例白名单的公共评论。如果选择共享允许，则此评论将显示在实例白名单旁边。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: public_comment
                  type: string
                - description: 有关此实例白名单的私人评论。仅显示给其他管理员，因此这是一个有用的内部方法，用于跟踪为什么某个域名最终被允许。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 如果 `import` != `true`，则返回新创建的实例白名单。如果导入了列表，则将返回新创建的实例白名单的 `array` (数组)。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_allows
            summary: 创建实例白名单
            tags:
                - admin
    /api/v1/admin/domain_allows/{id}:
        delete:
            operationId: domainAllowDelete
            parameters:
                - description: 实例白名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 刚刚删除的实例白名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_allows
            summary: 删除实例白名单条目
            description: 删除具有给定 ID 的实例白名单条目。
            tags:
                - admin
        get:
            operationId: domainAllowGet
            parameters:
                - description: 实例白名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的实例白名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:domain_allows
            summary: 查看实例白名单条目
            description: 查看具有给定 ID 的实例白名单条目。
            tags:
                - admin
        put:
            consumes:
                - multipart/form-data
            operationId: domainAllowUpdate
            parameters:
                - description: 实例白名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 公开展示时对域名进行混淆。例如，`example.org` 将变为类似于 `ex***e.org` 的文本。
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: 对该实例白名单条目的公开评论。当选择公开白名单时，此评论将显示在对应的实例白名单条目旁边。
                  in: formData
                  name: public_comment
                  type: string
                - description: 对该实例白名单条目的私密评论。仅显示给其他管理员，因此这是一个有用的内部方法，可用于跟踪为什么某个域名最终被允许。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的实例白名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_allows
            summary: 更新单个实例白名单条目
            tags:
                - admin
    /api/v1/admin/domain_blocks:
        get:
            operationId: domainBlocksGet
            parameters:
                - description: 如果设为 `true`，则返回的实例黑名单的每个条目将仅包含字段 `domain` 和 `public_comment`。这对于当您想要保存和共享您实例上阻止的所有实例的列表时非常有用，以便其他人可以轻松导入它们，但您不希望他们看到您的黑名单的数据库 ID，或私人评论等。
                  in: query
                  name: export
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 目前所有的实例黑名单。
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:domain_blocks
            summary: 查看实例黑名单
            description: 查看当前所有实例黑名单。
            tags:
                - admin
        put:
            consumes:
                - multipart/form-data
            operationId: domainBlockUpdate
            parameters:
                - description: 实例黑名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 公开展示时对域名进行混淆。例如，`example.org` 将变成类似于 `ex***e.org`。
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: 对此实例黑名单条目的公开评论。如果选择公开黑名单，此评论将显示在对应的实例黑名单条目旁边。
                  in: formData
                  name: public_comment
                  type: string
                - description: 对此实例黑名单条目的私密评论。仅显示给其他管理员，因此这是一个有用的内部方法，用于追踪为什么某个域名最终被屏蔽。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的实例黑名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_blocks
            summary: 更新单个实例黑名单条目
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            description: |-
                从字符串或文件中创建一个或多个实例黑名单条目。

                使用此端点时，您有两个选项：要么将 `import` 设置为 `true` 并上传一个包含多个要阻止联合的实例的 JSON 文件，要么将 `import` 设置为 `false`，并添加一个要阻止的实例。

                JSON 文件的格式应该类似于：`[{"domain":"example.org"},{"domain":"whatever.com","public_comment":"它们不是我的好厚米"}]`                
            operationId: domainBlockCreate
            parameters:
                - default: false
                  description: 表示正在导入一个包含多个要阻止联合的实例的文件。如果设置为 `true`，则 `domains` 必须作为 JSON 格式的文件存在。如果设置为 `false`，则 `domains` 将被忽略，`domain` 必须存在。
                  in: query
                  name: import
                  type: boolean
                - description: 要导入的 JSON 格式的实例黑名单。仅在 `import` 设置为 `true` 时使用。
                  in: formData
                  name: domains
                  type: file
                - description: 单个要阻止联合的实例。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: domain
                  type: string
                - description: 对外公开时对域名进行混淆。例如，`example.org` 变成类似于 `ex***e.org`。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: 对此实例黑名单条目的公开评论。如果选择共享阻止，此评论将显示在实例黑名单条目旁边。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: public_comment
                  type: string
                - description: 对此实例黑名单条目的私人评论。仅显示给其他管理员，因此这是一个有用的内部方法，用于跟踪为什么某个域名最终被阻止。仅在 `import` 不是 `true` 时使用。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 如果 `import` != `true`，则返回新创建的实例黑名单条目。如果导入了列表，则将返回新创建的实例黑名单的 `array` (数组)。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_blocks
            summary: 创建实例黑名单
            tags:
                - admin
    /api/v1/admin/domain_blocks/{id}:
        delete:
            operationId: domainBlockDelete
            parameters:
                - description: 实例黑名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 刚刚删除的实例黑名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:domain_blocks
            summary: 删除实例黑名单条目
            description: 删除具有给定 ID 的实例黑名单条目。
            tags:
                - admin
        get:
            operationId: domainBlockGet
            parameters:
                - description: 实例黑名单条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的实例黑名单条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:domain_blocks
            summary: 查看实例黑名单条目
            description: 查看具有给定 ID 的实例黑名单条目。
            tags:
                - admin
    /api/v1/admin/domain_keys_expire:
        post:
            consumes:
                - multipart/form-data
            description: |-
                将指定域名的所有帐户的缓存公钥强制吊销，这些公钥存储在您的数据库中。

                当外站实例不得不轮转其密钥时（出于安全问题、数据泄漏、例行安全程序等原因），此功能非常有用，您的实例无法使用缓存的密钥与其正常通信。以这种方式标记为过期的密钥将在下次由该密钥所有者签名的请求发送到您的实例时进行懒惰重新获取，因此不需要进一步操作即可重新建立与该域的通信。

                此端点务必不能用于轮转您自己的密钥，它仅适用于外站实例。

                使用此端点来吊销尚未轮转所有密钥的实例的密钥既不会有害，也不会破坏联合，但是毫无意义，会导致不必要的请求执行。                
            operationId: domainKeysExpire
            parameters:
                - description: |-
                    要吊销密钥的实例域名。
                    例如：example.org                    
                  in: formData
                  name: domain
                  type: string
                  x-go-name: Domain
            produces:
                - application/json
            responses:
                "202":
                    description: 请求已接受并将被处理。检查日志以查看进度/错误。
                    schema:
                        $ref: '#/definitions/adminActionResponse'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 已经有一个与此操作冲突的管理员操作正在执行。查看响应正文中的错误消息以获取更多信息。这是一个临时错误; 如果稍后再试一次，应该可以处理此操作。'
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 吊销实例密钥
            tags:
                - admin
    /api/v1/admin/domain_permission_drafts:
        get:
            description: |-
                该端点将返回按时间倒序排序（最新优先），并带有连续 ID 的域名权限草案（ID 值越大，草稿越新）。可以通过返回的 Link 标头解析下一页与上一页查询。
                
                示例:
                ```
                <https://example.org/api/v1/admin/domain_permission_drafts?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/domain_permission_drafts?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: domainPermissionDraftsGet
            parameters:
                - description: 仅显示给定订阅 ID 创建的草案。
                  in: query
                  name: subscription_id
                  type: string
                - description: 仅显示针对特定域名的草案。
                  in: query
                  name: domain
                  type: string
                - description: 筛选“屏蔽”与“放行”类型的草案。
                  in: query
                  name: permission_type
                  type: string
                - description: 仅返回早于给定 max ID 的条目（用于向下分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回晚于给定 since ID 的条目（用于向上分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回相邻且晚于给定 min ID 的条目（用于向上分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的条目数量。
                  in: query
                  maximum: 100
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限草案。
                    headers:
                        Link:
                            description: 下一查询与上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看域名权限草案。
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionDraftCreate
            parameters:
                - description: 该草案要针对的域名。
                  in: formData
                  name: domain
                  type: string
                - description: 草案类型为“放行”或“屏蔽”。
                  in: formData
                  name: permission_type
                  type: string
                - description: 对外公开展示时混淆具体域名。例如：`example.org` 将变为类似 `ex***e.org` 的字符串。
                  in: formData
                  name: obfuscate
                  type: boolean
                - description: 对此域名权限的公开评注。若您选择分享此权限设定，此评注将与权限条目一起显示。
                  in: formData
                  name: public_comment
                  type: string
                - description: 对此域名权限的私人评注。仅显示给其他管理员，因此这是一个可用于记录为什么某个域名最终被添加此权限设定的有用的内部手段。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的域名权限草案。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 使用给定参数创建一条域名权限草案。
            tags:
                - admin
    /api/v1/admin/domain_permission_drafts/{id}:
        get:
            operationId: domainPermissionDraftGet
            parameters:
                - description: 域名权限草案的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限草案。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取具有给定 ID 的域名权限草案。
            tags:
                - admin
    /api/v1/admin/domain_permission_drafts/{id}/accept:
        post:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionDraftAccept
            parameters:
                - description: 域名权限草案的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: false
                  description: 若已经存在一条具有相同域名与权限设定类型的草案，使用新草案的字段覆盖现有权限设定。
                  in: formData
                  name: overwrite
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的域名权限草案。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 接受一条域名权限草案，将其转换为会得到强制执行的域名权限。
            tags:
                - admin
    /api/v1/admin/domain_permission_drafts/{id}/remove:
        post:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionDraftRemove
            parameters:
                - description: 域名权限草案的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: false
                  description: 删除此域名权限草案时，为目标域名创建一个域名例外条目，以确保之后不会为此域名创建草案。
                  in: formData
                  name: exclude_target
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 被移除的域名权限草案。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 移除一条域名权限草案，可选择忽略所有之后的针对给定域名的草案。
            tags:
                - admin
    /api/v1/admin/domain_permission_excludes:
        get:
            description: |-
                返回按时间倒序排序（新创建的条目优先），并带有连续 ID 的域名权限例外条目（ID 值越大，例外条目越新）。可以通过返回的 Link 标头解析下一页与上一页查询。
                示例：
                ```
                <https://example.org/api/v1/admin/domain_permission_excludes?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/domain_permission_excludes?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ```                
            operationId: domainPermissionExcludesGet
            parameters:
                - description: 仅返回针对给定域名的例外条目。
                  in: query
                  name: domain
                  type: string
                - description: 仅返回比给定 max ID 新的条目（用于向下分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定 since ID 新的条目（用于向上分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回比给定 min ID 相邻且更新的条目（用于向上分页）。具有对应 ID 的条目不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的条目数量。
                  in: query
                  maximum: 100
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限例外条目。
                    headers:
                        Link:
                            description: 下一查询与上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/domainPermission'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看域名权限例外条目。
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
                - application/json
            description: |-
                被设为例外的域名（及其子域名）在导入或订阅域名权限列表时不会被自动阻止或允许。
                您仍然可以为被设为例外的域名手动创建域名阻止条目或域名允许条目，被设为例外之后，与该域名关联的任何的已有或新创建的域名阻止条目或域名允许条目都将被继续执行。                
            operationId: domainPermissionExcludeCreate
            parameters:
                - description: 要创建的权限例外条目的目标域名。
                  in: formData
                  name: domain
                  type: string
                - description: 对该域名例外条目的私密评论。
                  in: formData
                  name: private_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的域名例外条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 使用给定参数创建一个域名权限例外条目。
            tags:
                - admin
    /api/v1/admin/domain_permission_excludes/{id}:
        delete:
            operationId: domainPermissionExcludeDelete
            parameters:
                - description: 该域名权限例外条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被移除的域名权限例外条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 移除一个域名权限例外条目。
            tags:
                - admin
        get:
            operationId: domainPermissionExcludeGet
            parameters:
                - description: 域名权限例外条目的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限例外条目。
                    schema:
                        $ref: '#/definitions/domainPermission'
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取具有给定 ID 的域名权限例外条目。
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions:
        get:
            description: |-
                订阅将按时间倒序返回（最新的订阅在前），并带有连续的 ID （值越大代表订阅越新）。
                可以通过返回的 Link 标头解析下一页与上一页查询。
                示例：
                ```
                <https://example.org/api/v1/admin/domain_permission_subscriptions?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/domain_permission_subscriptions?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: domainPermissionSubscriptionsGet
            parameters:
                - description: 筛选类型为“阻止”或“允许”的订阅。
                  in: query
                  name: permission_type
                  type: string
                - description: 仅返回 ID 小于给定的最大 ID 的条目（用于向下分页）。具有对应 ID 的条目不会包含在结果中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回 ID 大于给定的最小 ID 的条目（用于向上分页）。具有对应 ID 的条目不会包含在结果中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回 ID 比指定最小 ID 相邻且*更新* 的条目（用于向上分页）。具有对应 ID 的条目不会包含在结果中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的条目数量。
                  in: query
                  maximum: 100
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限订阅列表。
                    headers:
                        Link:
                            description: 下一查询与上一查询的链接
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/domainPermissionSubscription'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看域名权限订阅列表
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionSubscriptionCreate
            parameters:
                - default: 0
                  description: 此订阅相对于其他同类型的订阅的优先级。取值范围为 0-255 （数值越高，优先级越高）。优先级较高的订阅将会覆盖优先级较低的订阅生成的权限。当两个订阅的`priority`（优先级）值相同时，优先级无法确定，因此建议始终手动设置此值。
                  in: formData
                  maximum: 255
                  minimum: 0
                  name: priority
                  type: number
                - description: 此订阅的标题（可选）
                  in: formData
                  name: title
                  type: string
                - description: 解析订阅列表/订阅目标文件时要创建的域名权限类型。需要为 "allow" 或 "block"。
                  in: formData
                  name: permission_type
                  required: true
                  type: string
                - default: true
                  description: 如果为 true，此订阅产生的域名权限条目将以草稿形式创建，须管理员批准后才能生效。如果为 false，此订阅下的域名权限条目将立即生效。默认为 true。
                  in: formData
                  name: as_draft
                  type: boolean
                - default: false
                  description: '若为 true，则此域名权限订阅将“接管”实例上已存在的、符合以下条件的域名权限： 1）它们没有关联的订阅 ID（即，它们是“孤立”的）， 2）它们存在于订阅列表中。这些孤立的域名权限条目将被关联到此订阅的订阅 ID，并由此订阅管理。'
                  in: formData
                  name: adopt_orphans
                  type: boolean
                - description: 此订阅要获取的权限列表的 URI。
                  in: formData
                  name: uri
                  required: true
                  type: string
                - description: 此订阅要使用的 MIME 内容类型。可以为 "text/plain"、"text/csv" 或 "application/json"。
                  in: formData
                  name: content_type
                  required: true
                  type: string
                - description: 可选的基本身份验证（Basic Auth）用户名，用于获取指定 URI。如果设置，则在获取时会与 `fetch_password` 一起传输。
                  in: formData
                  name: fetch_username
                  type: string
                - description: 可选的基本身份验证（Basic Auth）密码，用于获取指定 URI。如果设置，则在获取时会与 `fetch_username` 一起传输。
                  in: formData
                  name: fetch_password
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的域名权限订阅。
                    schema:
                        $ref: '#/definitions/domainPermissionSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 创建域名权限订阅
            description: 使用给定参数创建一个新的域名权限订阅。
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions/${id}:
        patch:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionSubscriptionUpdate
            parameters:
                - description: 域名权限订阅的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 此订阅相对于其他同类型的订阅的优先级。取值范围为 0-255 （数值越高，优先级越高）。优先级较高的订阅将会覆盖优先级较低的订阅生成的权限。当两个订阅的`priority`（优先级）值相同时，优先级无法确定，因此建议始终手动设置此值。
                  in: formData
                  maximum: 255
                  minimum: 0
                  name: priority
                  type: number
                - description: 此订阅的标题（可选）。
                  in: formData
                  name: title
                  type: string
                - description: 此订阅要获取的域名权限列表的 URI。
                  in: formData
                  name: uri
                  type: string
                - default: true
                  description: 如果为 true，此订阅产生的域名权限条目将以草稿形式创建，须管理员批准后才能生效。如果为 false，此订阅下的域名权限条目将立即生效。默认为 true。
                  in: formData
                  name: as_draft
                  type: boolean
                - default: false
                  description: '若为 true，则此域名权限订阅将“接管”实例上已存在的、符合以下条件的域名权限： 1）它们没有关联的订阅 ID（即，它们是“孤立”的）， 2）它们存在于订阅列表中。这些孤立的域名权限条目将被关联到此订阅的订阅 ID，并由此订阅管理。'
                  in: formData
                  name: adopt_orphans
                  type: boolean
                - description: 此订阅要使用的 MIME 内容类型。可以为 "text/plain"、"text/csv" 或 "application/json"。
                  in: formData
                  name: content_type
                  type: string
                - description: 可选的基本身份验证（Basic Auth）用户名，用于获取指定 URI。如果设置，则在获取时会与 `fetch_password` 一起传输。
                  in: formData
                  name: fetch_username
                  type: string
                - description: 可选的基本身份验证（Basic Auth）密码，用于获取指定 URI。如果设置，则在获取时会与 `fetch_username` 一起传输。
                  in: formData
                  name: fetch_password
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的域名权限订阅。
                    schema:
                        $ref: '#/definitions/domainPermissionSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 更新域名权限订阅
            description: 使用给定参数更新一个域名权限订阅。
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions/{id}:
        get:
            operationId: domainPermissionSubscriptionGet
            parameters:
                - description: 域名权限订阅的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 要获取的域名权限订阅。
                    schema:
                        $ref: '#/definitions/domainPermissionSubscription'
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取指定域名权限订阅
            description: 获取具有给定 ID 的单个域名权限订阅。
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions/{id}/remove:
        post:
            consumes:
                - multipart/form-data
                - application/json
            operationId: domainPermissionSubscriptionRemove
            parameters:
                - description: 域名权限订阅的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - default: true
                  description: |-
                    移除域名权限订阅时，也应移除此订阅的子条目，即由该订阅管理的域名权限。如果为否，则子条目将成为孤立条目，但不会被移除。
                    请注意，已被移除的权限条目可能稍后会被另一个优先级低于已移除订阅的域名权限订阅重新创建。同样地，孤立子项也可能稍后被另一个订阅接收。                    
                  in: formData
                  name: remove_children
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 被移除的域名权限订阅。
                    schema:
                        $ref: '#/definitions/domainPermissionSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 删除单个域名权限订阅
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions/{id}/test:
        post:
            description: |-
                让你的实例获取并解析域名权限订阅列表，来测试单个域名权限订阅，*无需实际创建权限*。

                响应体将为一个该订阅*将会*创建的域权限列表，或是一条错误消息。

                这在你需要检查你的实例是否能够实际获取和解析列表的情况下非常有用。                
            operationId: domainPermissionSubscriptionTest
            parameters:
                - description: 该域名权限订阅草稿的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 一个域名权限条目的数组，或一个说明为何无法获取该列表的，形如 `{"error":"[错误信息]"}` 的错误消息。
                    schema:
                        items:
                            $ref: '#/definitions/domain'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 测试单个域名权限订阅
            tags:
                - admin
    /api/v1/admin/domain_permission_subscriptions/preview:
        get:
            description: 查看给定权限类型的全部域名权限订阅，按优先级顺序排列（从高到低）。此视图可显示实际被获取和创建的域名权限订阅的顺序。
            operationId: domainPermissionSubscriptionsPreviewGet
            parameters:
                - description: 筛选类型为 "block" 或 "allow" 的订阅。
                  in: query
                  name: permission_type
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 域名权限订阅列表。
                    schema:
                        items:
                            $ref: '#/definitions/domainPermissionSubscription'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止访问
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 预览全部域名权限订阅
            tags:
                - admin
    /api/v1/admin/email/test:
        post:
            consumes:
                - multipart/form-data
            description: |-
                向指定的电子邮件地址发送一封通用的测试电子邮件。

                这可以用来验证实例的 SMTP 配置，并调试任何潜在问题。

                如果 SMTP 连接返回错误，此处理程序将返回代码 422，以指示请求无法处理，并将 SMTP 错误返回给调用者。                
            operationId: testEmailSend
            parameters:
                - description: 要发送测试电子邮件的电子邮件地址。
                  in: formData
                  name: email
                  required: true
                  type: string
                - description: 要包含在电子邮件中的消息，可不填。
                  in: formData
                  name: message
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: 测试邮件已发送。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: 尝试发件时发生了一个 smtp 错误。检查返回的 json 以获取更多信息。将包含 smtp 错误，以帮助您调试与 smtp 服务器的通信。
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 测试电子邮件
            tags:
                - admin
    /api/v1/admin/header_allows:
        get:
            operationId: headerFilterAllowsGet
            responses:
                "200":
                    description: 目前所有的标头 "allow" (放行) 过滤规则。
                    schema:
                        items:
                            $ref: '#/definitions/headerFilter'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看标头放行规则
            description: 查看当前所有 "allow" (放行) 过滤规则。
            tags:
                - admin
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                创建一条新的 "allow" (放行) HTTP 请求标头过滤规则。
                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
                若 Content-Type 为 'application/xml'，则参数也可以在请求体中以 XML 形式给出。                
            operationId: headerFilterAllowCreate
            parameters:
                - description: 要匹配的 HTTP 标头 (例如 User-Agent)。
                  in: formData
                  name: header
                  required: true
                  type: string
                  x-go-name: Header
                - description: 要匹配的标头值的正则表达式。
                  in: formData
                  name: regex
                  required: true
                  type: string
                  x-go-name: Regex
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的 "allow" (放行) 标头过滤规则。
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 创建标头放行规则
            tags:
                - admin
    /api/v1/admin/header_allows/{id}:
        delete:
            operationId: headerFilterAllowDelete
            parameters:
                - description: 目标标头过滤规则 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "202":
                    description: Accepted 已接受
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 删除标头放行规则
            description: 删除具有给定 ID 的 "allow" (放行) 标头过滤规则。
            tags:
                - admin
        get:
            operationId: headerFilterAllowGet
            parameters:
                - description: 目标标头过滤规则 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "200":
                    description: 请求的 "allow" (放行) 标头过滤规则。
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取单个标头放行规则
            description: 获取具有给定 ID 的 "allow" (放行) 标头过滤规则。
            tags:
                - admin
    /api/v1/admin/header_blocks:
        get:
            operationId: headerFilterBlocksGet
            responses:
                "200":
                    description: 目前所有的 "block" (阻止) 标头过滤规则。
                    schema:
                        items:
                            $ref: '#/definitions/headerFilter'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看标头阻止规则
            description: 获取目前所有的 "block" (阻止) 标头过滤规则。
            tags:
                - admin
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                创建一条新的 "block" (阻止) HTTP 请求标头过滤规则。
                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
                若 Content-Type 为 'application/xml'，则参数也可以在请求体中以 XML 形式给出。                
            operationId: headerFilterBlockCreate
            parameters:
                - description: 要匹配的 HTTP 标头 (例如 User-Agent)。
                  in: formData
                  name: header
                  required: true
                  type: string
                  x-go-name: Header
                - description: 要匹配的标头值的正则表达式。
                  in: formData
                  name: regex
                  required: true
                  type: string
                  x-go-name: Regex
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的 "block" (阻止) 标头过滤规则。
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 创建标头阻止规则
            tags:
                - admin
    /api/v1/admin/header_blocks/{id}:
        delete:
            operationId: headerFilterBlockDelete
            parameters:
                - description: 目标标头过滤规则 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "202":
                    description: Accepted 已接受
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 删除标头阻止规则
            description: 删除具有给定 ID 的 "block" (阻止) 标头过滤规则。
            tags:
                - admin
        get:
            operationId: headerFilterBlockGet
            parameters:
                - description: 目标标头过滤规则 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            responses:
                "200":
                    description: 请求的 "block" (阻止) 标头过滤规则。
                    schema:
                        $ref: '#/definitions/headerFilter'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取单个标头阻止规则
            description: 获取具有给定 ID 的 "block" (阻止) 标头过滤规则。
            tags:
                - admin
    /api/v1/admin/instance/rules:
        get:
            description: 实例规则将按 Order 升序返回。
            operationId: adminsRuleGet
            produces:
                - application/json
            responses:
                "200":
                    description: 本站实例的所有规则组成的数组。
                    schema:
                        items:
                            $ref: '#/definitions/instanceRule'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 查看实例规则（含ID）
            tags:
                - admin
        post:
            consumes:
                - multipart/form-data
            operationId: ruleCreate
            parameters:
                - description: 实例规则的文本内容，纯文本。
                  in: formData
                  name: text
                  required: true
                  type: string
                  x-go-name: Text
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的实例规则。
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 创建实例规则
            description: 创建一条新的实例规则。
            tags:
                - admin
    /api/v1/admin/instance/rules/{id}:
        delete:
            consumes:
                - multipart/form-data
            operationId: ruleDelete
            parameters:
                - description: 要删除的规则的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被删除的实例规则。
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 删除实例规则
            description: 删除一条现有的实例规则。
            tags:
                - admin
        get:
            operationId: adminRuleGet
            parameters:
                - description: 要获取的实例规则的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 要获取的实例规则。
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read
            summary: 获取单条实例规则
            tags:
                - admin
        patch:
            consumes:
                - multipart/form-data
            operationId: ruleUpdate
            parameters:
                - description: 要更新的规则的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                  x-go-name: ID
                - description: 更新的实例规则的文本内容，纯文本。
                  in: formData
                  name: text
                  required: true
                  type: string
                  x-go-name: Text
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的实例规则。
                    schema:
                        $ref: '#/definitions/instanceRule'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 更新实例规则
            description: 更新一条现有的实例规则。
            tags:
                - admin
    /api/v1/admin/media_cleanup:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: 删除早于给定日期的外站媒体。也会清理未使用的头像和横幅背景头图，并从存储中删除孤立的项目。
            operationId: mediaCleanup
            parameters:
                - description: |-
                    要保留的外站媒体的天数。本地(Native)值将被视为 0。
                    若未指定值，则将使用服务器配置中的 media-remote-cache-days 的值。                    
                  format: int64
                  in: query
                  name: remote_cache_days
                  type: integer
                  x-go-name: RemoteCacheDays
            produces:
                - application/json
            responses:
                "200":
                    description: 返回请求的天数。清理将在请求完成后异步执行。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 清理媒体
            tags:
                - admin
    /api/v1/admin/media_refetch:
        post:
            description: |-
                重新获取数据库中指定但在存储中丢失的媒体。
                当前，仅包括外站表情。
                当数据丢失时，您可以使用此端点尝试恢复到工作状态。                
            operationId: mediaRefetch
            parameters:
                - description: 要重新获取媒体的实例。如果为空，则将重新获取所有实例的媒体。
                  in: query
                  name: domain
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: 请求已接受并将被处理。检查日志以查看进度/错误。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 重新获取媒体
            tags:
                - admin
    /api/v1/admin/reports:
        get:
            description: |-
                查看发给管理员的用户举报。

                举报将按时间顺序（最新的在前）返回，带有连续的 ID（更大 = 更新）。

                下一个和上一个查询可以从返回的Link标头中解析。

                例子：

                ```
                <https://example.org/api/v1/admin/reports?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/admin/reports?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: adminReports
            parameters:
                - description: 如果设为 true，则只返回已解决的举报。如果设为 false，则只返回未解决的举报。如果未设置，则不会根据其解决状态过滤举报。
                  in: query
                  name: resolved
                  type: boolean
                - description: 只返回由给定 ID 的账户创建的举报。
                  in: query
                  name: account_id
                  type: string
                - description: 只返回针对给定 ID 的账户的举报。
                  in: query
                  name: target_account_id
                  type: string
                - description: 只返回比给定的 max ID *旧* 的举报（用于向下翻页）。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回比给定的 since ID *新* 的举报。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的 min ID 相邻且*更新* 的举报（用于向上翻页）。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的举报数量。
                  in: query
                  maximum: 100
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 举报数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/adminReport'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:reports
            summary: 查看用户举报
            tags:
                - admin
    /api/v1/admin/reports/{id}:
        get:
            operationId: adminReportGet
            parameters:
                - description: 举报的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的举报。
                    schema:
                        $ref: '#/definitions/adminReport'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:reports
            summary: 查看单个用户举报
            description: 查看具有给定 ID 的用户举报。
            tags:
                - admin
    /api/v1/admin/reports/{id}/resolve:
        post:
            consumes:
                - application/json
                - application/xml
                - multipart/form-data
            operationId: adminReportResolve
            parameters:
                - description: 举报的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    管理员对此举报采取的行动的评论，可不填。在将举报标记为已处理之前，提供关于采取的行动（如果有）的解释非常有用。这将对创建举报的用户可见！                    
                  in: formData
                  name: action_taken_comment
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 已处理的举报。
                    schema:
                        $ref: '#/definitions/adminReport'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write:reports
            summary: 处理用户举报
            description: 将具有给定 ID 的用户举报标记为已处理。
            tags:
                - admin
    /api/v1/announcements:
        get:
            operationId: announcementsGet
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            type: object
                        maxItems: 0
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer: []
            summary: 获取公告
            description: '以数组形式获取当前生效的公告。此端点目前尚未完全实现：它将无条件返回一个空数组。'
            tags:
                - announcements
    /api/v1/apps:
        get:
            description: |-
                获取由请求者管理的应用程序的数组。
                可从返回的 Link 标头解析出下一页和上一页的查询地址。

                示例：

                ```
                <https://example.org/api/v1/apps?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/apps?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: appsGet
            parameters:
                - description: 只返回比给定的 max ID *旧* 的应用。具有指定 ID 的应用不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回比给定的 since ID *新* 的应用。具有指定 ID 的应用不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的 min ID *相邻且更新* 的应用（用于向上翻页）。具有指定 ID 的应用不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的应用数量。
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/application'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:applications
            summary: 获取应用列表
            tags:
                - apps
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                在本实例注册一个新的应用程序。
                注册的应用程序可用于获取应用程序令牌。
                然后可以使用此令牌注册新帐户，或（通过用户身份验证）获取访问令牌。

                如果应用程序是通过在 Authorization 标头中使用 Bearer 令牌创建的，则新创建的应用程序将由经过对应的的用户管理（Bearer 令牌必须具有 write:applications 范围）。

                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
                若 Content-Type 为 'application/xml'，则参数也可以在请求体中以 XML 形式给出。                
            operationId: appCreate
            parameters:
                - description: 应用程序的名称。
                  in: formData
                  name: client_name
                  required: true
                  type: string
                  x-go-name: ClientName
                - description: |-
                    单个重定向 URI 或以换行符分隔的重定向 URI 列表（可选）。

                    若要向用户显示授权代码而不是重定向到网页，请在此参数中使用 `urn:ietf:wg:oauth:2.0:oob`。

                    如果未提供重定向 URI，则默认为 `urn:ietf:wg:oauth:2.0:oob`。                    
                  in: formData
                  name: redirect_uris
                  type: string
                  x-go-name: RedirectURIs
                - description: |-
                    授权范围，以空格分隔的列表（可选）。

                    如果未提供范围，则默认为 `read`。                    
                  in: formData
                  name: scopes
                  type: string
                  x-go-name: Scopes
                - description: 此应用程序的网页 URL（可选）。
                  in: formData
                  name: website
                  type: string
                  x-go-name: Website
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的应用程序。
                    schema:
                        $ref: '#/definitions/application'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            summary: 创建应用程序
            tags:
                - apps
    /api/v1/apps/{id}:
        delete:
            operationId: appDelete
            parameters:
                - description: 要删除的应用程序的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被删除的应用程序。
                    schema:
                        $ref: '#/definitions/application'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:applications
            summary: 删除单个应用
            description: 删除单个由请求者管理的应用程序。
            tags:
                - apps
        get:
            operationId: appGet
            parameters:
                - description: 要请求的应用程序的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的应用程序。
                    schema:
                        $ref: '#/definitions/application'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:applications
            summary: 获取单个应用
            description: 获取单个由请求者管理的应用程序。
            tags:
                - apps
    /api/v1/blocks:
        get:
            description: |-
                获取发起请求的账户已屏蔽的账户数组。
                下一个和上一个查询可以从返回的Link标头中解析。
                示例：

                ```
                <https://example.org/api/v1/blocks?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/blocks?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: blocksGet
            parameters:
                - description: '仅返回早于给定的 max ID 的已屏蔽账户。具有指定 ID 的已屏蔽账户不会包含在响应中。注意：ID 是内部屏蔽的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回晚于给定的 since ID 的已屏蔽账户。具有指定 ID 的已屏蔽账户不会包含在响应中。注意：ID 是内部屏蔽的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回比给定的 min ID *相邻且更新* 的已屏蔽账户。具有指定 ID 的已屏蔽账户不会包含在响应中。注意：ID 是内部屏蔽的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的已屏蔽账户数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:blocks
            summary: 获取已屏蔽账户
            tags:
                - blocks
    /api/v1/bookmarks:
        get:
            description: 获取在本站收藏的贴文的数组。
            operationId: bookmarksGet
            parameters:
                - default: 30
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
                - description: 仅返回早于给定的收藏 ID 的已收藏贴文。具有相应收藏 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的收藏 ID *新* 的已收藏贴文。具有相应收藏 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 已收藏贴文的数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:bookmarks
            summary: 获取收藏列表
            tags:
                - bookmarks
    /api/v1/conversation/{id}/read:
        post:
            operationId: conversationRead
            parameters:
                - description: 对话的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的对话。
                    schema:
                        $ref: '#/definitions/conversation'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理 content
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:conversations
            summary: 标记对话为已读
            description: 将具有给定 ID 的对话标记为已读。
            tags:
                - conversations
    /api/v1/conversations:
        get:
            description: |-
                获取发起请求的账户参与的对话（私信）数组。
                下一个和上一个查询可以从返回的Link标头中解析。
                示例：

                ```
                <https://example.org/api/v1/conversations?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/conversations?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: conversationsGet
            parameters:
                - description: '仅返回最后贴文早于给定的 max ID 的对话。具有相应贴文 ID 的对话不会包含在响应中。注意：ID 是贴文 ID。使用Link标头进行分页。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回最后贴文晚于给定的 since ID 的对话。具有相应贴文 ID 的对话不会包含在响应中。注意：ID 是贴文 ID。使用Link标头进行分页。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回最后贴文 **相邻且晚于** 给定的 since ID 的对话。具有相应贴文 ID 的对话不会包含在响应中。注意：ID 是贴文 ID。使用Link标头进行分页。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的对话数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/conversation'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 获取对话列表
            tags:
                - conversations
    /api/v1/conversations/{id}:
        delete:
            description: |-
                删除具有给定 ID 的单个对话。
                这不会删除对话包含的实际贴文，也不会阻止参与者稍后从相同的贴文串和参与者创建新对话。                
            operationId: conversationDelete
            parameters:
                - description: 对话的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 对话已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:conversations
            summary: 删除对话
            tags:
                - conversations
    /api/v1/custom_emojis:
        get:
            operationId: customEmojisGet
            produces:
                - application/json
            responses:
                "200":
                    description: 自定义表情数组。
                    schema:
                        items:
                            $ref: '#/definitions/emoji'
                        type: array
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer: []
            summary: 获取自定义表情
            description: 获取本实例可用的自定义表情数组。
            tags:
                - custom_emojis
    /api/v1/exports/blocks.csv:
        get:
            operationId: exportBlocks
            produces:
                - text/csv
            responses:
                "200":
                    description: 你屏蔽的账户的 CSV 文件。
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:blocks
            summary: 导出屏蔽列表
            description: 导出你屏蔽的账户的 CSV 文件。
            tags:
                - import-export
    /api/v1/exports/followers.csv:
        get:
            operationId: exportFollowers
            produces:
                - text/csv
            responses:
                "200":
                    description: 你的粉丝的 CSV 文件。
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 导出粉丝列表
            description: 导出你的粉丝的 CSV 文件。
            tags:
                - import-export
    /api/v1/exports/following.csv:
        get:
            operationId: exportFollowing
            produces:
                - text/csv
            responses:
                "200":
                    description: 你关注的账户的 CSV 文件。
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:follows
            summary: 导出关注列表
            description: 导出你关注的账户的 CSV 文件。
            tags:
                - import-export
    /api/v1/exports/lists.csv:
        get:
            operationId: exportLists
            produces:
                - text/csv
            responses:
                "200":
                    description: 列表的 CSV 文件。
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 导出所有列表
            description: 导出你创建的列表的 CSV 文件。
            tags:
                - import-export
    /api/v1/exports/mutes.csv:
        get:
            operationId: exportMutes
            produces:
                - text/csv
            responses:
                "200":
                    description: 你屏蔽的账户的 CSV 文件。
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:mutes
            summary: 导出静音列表
            description: 导出你静音/隐藏的账户的 CSV 文件。
            tags:
                - import-export
    /api/v1/exports/stats:
        get:
            operationId: exportStats
            produces:
                - application/json
            responses:
                "200":
                    description: 导出统计信息
                    schema:
                        $ref: '#/definitions/accountExportStats'
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看导出统计信息
            description: 返回对应账户有关可以导出的项目数量的统计信息。
            tags:
                - import-export
    /api/v1/favourites:
        get:
            description: |-
                查看发起请求的账户已点赞的贴文数组。
                下一个和上一个查询可以从返回的Link标头中解析。
                示例:

                ```
                <https://example.org/api/v1/favourites?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/favourites?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: favouritesGet
            parameters:
                - default: 20
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
                - description: 仅返回比给定的点赞 ID *旧* 的贴文。具有相应点赞 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的点赞 ID *新* 的贴文。具有相应点赞 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:favourites
            summary: 查看点赞贴文
            tags:
                - favourites
    /api/v1/featured_tags:
        get:
            description: '获取你当前在个人资料上展示的所有话题标签的数组。**此端点尚未完全实现**：它将始终返回一个空数组。'
            operationId: getFeaturedTags
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            type: object
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取精选话题标签
            tags:
                - tags
    /api/v1/filters:
        get:
            operationId: filtersV1Get
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则。
                    schema:
                        items:
                            $ref: '#/definitions/filterV1'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取V1过滤规则
            description: 获取发起请求的账户的所有过滤规则。
            tags:
                - filters
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterV1Post
            parameters:
                - description: |-
                    要过滤的文本。

                    示例：挂人                    
                  in: formData
                  maxLength: 40
                  minLength: 1
                  name: phrase
                  required: true
                  type: string
                - collectionFormat: multi
                  description: |-
                    此过滤规则要应用的上下文。

                    示例: home, public                    
                  in: formData
                  items:
                    enum:
                        - home
                        - notifications
                        - public
                        - thread
                        - account
                    type: string
                  minItems: 1
                  name: context[]
                  required: true
                  type: array
                  uniqueItems: true
                - description: |-
                    此过滤规则的过期时间（秒）。如果省略，则过滤规则永不过期。

                    示例：86400                    
                  in: formData
                  name: expires_in
                  type: number
                - default: false
                  description: |-
                    被命中的条目是否应该从用户的时间线/视图中移除，而不是隐藏？目前不支持。

                    示例：false                    
                  in: formData
                  name: irreversible
                  type: boolean
                - default: false
                  description: |-
                    此过滤规则是否应考虑单词边界（整词匹配）？

                    示例：true                    
                  in: formData
                  name: whole_word
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 新过滤规则。
                    schema:
                        $ref: '#/definitions/filterV1'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict (duplicate keyword)
                "422":
                    description: unprocessable 无法处理 content
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 创建V1过滤规则
            description: 创建一条新的V1过滤规则。
            tags:
                - filters
    /api/v1/filters/{id}:
        delete:
            operationId: filterV1Delete
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 过滤规则已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 删除V1过滤规则
            description: 删除具有给定 ID 的单个过滤规则。
            tags:
                - filters
        get:
            operationId: filterV1Get
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则。
                    schema:
                        $ref: '#/definitions/filterV1'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取单个V1过滤规则
            description: 获取具有给定 ID 的单个V1过滤规则。
            tags:
                - filters
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterV1Put
            parameters:
                - description: 过滤规则的 ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    要过滤的文本。

                    示例: 挂人                    
                  in: formData
                  maxLength: 40
                  minLength: 1
                  name: phrase
                  required: true
                  type: string
                - collectionFormat: multi
                  description: |-
                    此过滤规则要应用的上下文。

                    示例: home, public                    
                  in: formData
                  items:
                    enum:
                        - home
                        - notifications
                        - public
                        - thread
                        - account
                    type: string
                  minItems: 1
                  name: context[]
                  required: true
                  type: array
                  uniqueItems: true
                - description: |-
                    此过滤规则的过期时间（秒）。如果省略，则过滤规则永不过期。

                    示例: 86400                    
                  in: formData
                  name: expires_in
                  type: number
                - default: false
                  description: |-
                    被命中的条目是否应该从用户的时间线/视图中移除，而不是隐藏？目前不支持。

                    示例: false                    
                  in: formData
                  name: irreversible
                  type: boolean
                - default: false
                  description: |-
                    此过滤规则是否应考虑单词边界（整词匹配）？

                    示例: true                    
                  in: formData
                  name: whole_word
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的过滤规则。
                    schema:
                        $ref: '#/definitions/filterV1'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict (duplicate keyword)
                "422":
                    description: unprocessable 无法处理 content
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 更新单个V1过滤规则
            description: 更新具有给定 ID 的单个过滤规则。
            tags:
                - filters
    /api/v1/follow_requests:
        get:
            description: |-
                获取向你发起关注请求的账户数组。
                下一个和上一个查询可以从返回的Link标头中解析。
                示例:

                ```
                <https://example.org/api/v1/follow_requests?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/follow_requests?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: getFollowRequests
            parameters:
                - description: '仅返回比给定的 max ID *旧* 的关注请求账户。具有指定 ID 的关注请求账户不会包含在响应中。注意：ID 是内部关注请求的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回比给定的 since ID *新* 的关注请求账户。具有指定 ID 的关注请求账户不会包含在响应中。注意：ID 是内部关注请求的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回比给定的 min ID *相邻且更新* 的关注请求账户。具有指定 ID 的关注请求账户不会包含在响应中。注意：ID 是内部关注请求的 ID，而不是任何返回的账户的 ID。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的关注请求账户数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:follows
            summary: 获取关注请求列表
            tags:
                - follow_requests
    /api/v1/follow_requests/{account_id}/authorize:
        post:
            description: 接受/批准来自给定账户 ID 的关注请求，并将请求账户放入你的“粉丝”列表。
            operationId: authorizeFollowRequest
            parameters:
                - description: 要接受的账户的 ID。
                  in: path
                  name: account_id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 接受关注请求
            tags:
                - follow_requests
    /api/v1/follow_requests/{account_id}/reject:
        post:
            operationId: rejectFollowRequest
            parameters:
                - description: 要拒绝的账户的 ID。
                  in: path
                  name: account_id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 你与此账户的关系(relationship)。
                    schema:
                        $ref: '#/definitions/accountRelationship'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 拒绝关注请求
            description: 拒绝来自给定账户 ID 的关注请求。
            tags:
                - follow_requests
    /api/v1/followed_tags:
        get:
            operationId: getFollowedTags
            parameters:
                - description: '仅返回比给定的 max ID *旧* 的已关注话题标签。具有相应 max ID 的已关注话题标签不会包含在响应中。注意：ID 是已关注话题标签的内部 ID，而不是任何返回的话题标签的 ID。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回比给定的 since ID *新* 的已关注话题标签。具有相应 since ID 的已关注话题标签不会包含在响应中。注意：ID 是已关注话题标签的内部 ID，而不是任何返回的话题标签的 ID。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回比给定的 min ID *相邻且更新* 的已关注话题标签。具有相应 min ID 的已关注话题标签不会包含在响应中。注意：ID 是已关注话题标签的内部 ID，而不是任何返回的话题标签的 ID。'
                  in: query
                  name: min_id
                  type: string
                - default: 100
                  description: 要返回的已关注话题标签数量。
                  in: query
                  maximum: 200
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/tag'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:follows
            summary: 获取已关注话题标签
            description: 获取你当前关注的所有话题标签的数组。
            tags:
                - tags
    /api/v1/import:
        post:
            consumes:
                - multipart/form-data
            description: |-
                将 CSV 数据文件上传到你的账户。
                这可以用于从 Mastodon 兼容的 CSV 文件迁移数据到 GoToSocial 账户。

                上传的数据将异步处理，并且可能不会处理所有条目，具体取决于实例屏蔽、用户级屏蔽、引用账户和状态的网络可用性等。                
            operationId: importData
            parameters:
                - description: 要上传的 CSV 数据文件。
                  in: formData
                  name: data
                  required: true
                  type: file
                - description: |-
                    此数据文件中包含的条目类型：
                    - `following` - 要关注的账户。 - `blocks` - 要屏蔽的账户。 - `mutes` - 要隐藏的账户。                    
                  in: formData
                  name: type
                  required: true
                  type: string
                - default: merge
                  description: |-
                    根据数据文件创建对应的条目时使用的模式：
                    - `merge` 将数据文件中的条目与现有条目合并。 - `overwrite` 用数据文件中的条目替换现有条目。                    
                  in: formData
                  name: mode
                  type: string
            produces:
                - application/json
            responses:
                "202":
                    description: 上传的数据文件已被接受。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write
            summary: 导入数据
            tags:
                - import-export
    /api/v1/instance:
        get:
            operationId: instanceGetV1
            produces:
                - application/json
            responses:
                "200":
                    description: 实例信息
                    schema:
                        $ref: '#/definitions/instanceV1'
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal error
            summary: 查看实例信息
            tags:
                - instance
        patch:
            consumes:
                - multipart/form-data
            description: 更新实例信息和/或上传新的头像/横幅头图。此端点需要实例管理员权限。
            operationId: instanceUpdate
            parameters:
                - allowEmptyValue: true
                  description: 实例的标题。
                  in: formData
                  maxLength: 40
                  name: title
                  type: string
                - allowEmptyValue: true
                  description: 联系账户的用户名。这必须是实例管理员的用户名。
                  in: formData
                  name: contact_username
                  type: string
                - allowEmptyValue: true
                  description: 实例联系邮箱。
                  in: formData
                  name: contact_email
                  type: string
                - allowEmptyValue: true
                  description: 实例的简短描述。
                  in: formData
                  maxLength: 500
                  name: short_description
                  type: string
                - allowEmptyValue: true
                  description: 实例的详细描述。
                  in: formData
                  maxLength: 5000
                  name: description
                  type: string
                - allowEmptyValue: true
                  description: 实例的条款和条件。
                  in: formData
                  maxLength: 5000
                  name: terms
                  type: string
                - description: 实例的缩略图。
                  in: formData
                  name: thumbnail
                  type: file
                - description: 提交的实例缩略图的图像描述。
                  in: formData
                  name: thumbnail_description
                  type: string
                - description: 实例的头部背景横幅。
                  in: formData
                  name: header
                  type: file
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的实例信息。
                    schema:
                        $ref: '#/definitions/instanceV1'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:write
            summary: 更新实例信息
            tags:
                - instance
    /api/v1/instance/peers:
        get:
            operationId: instancePeersGet
            parameters:
                - default: open
                  description: |-
                    要应用于结果的过滤规则列表，以逗号分隔。可被识别的过滤规则包括：
                      - `open` -- 包括未被禁止或静音的同伴实例
                      - `suspended` -- 包括已被禁止的同伴实例。

                    如果过滤规则是 `open`，则只会返回未被禁止或静音的实例。

                    如果过滤规则是 `suspended`，则只会显示已被禁止的实例。

                    如果过滤规则是 `open,suspended`，则将返回所有已知实例。

                    如果过滤规则是空字符串或未设置，则将默认为 `open`。                    
                  in: query
                  name: filter
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: |-
                        如果未提供 filter 参数，或 filter 为空，则将返回一个遗留的、与 Mastodon-API 兼容的响应。这将仅包含一个类似 `["example.com", "example.org"]` 的字符串数组，对应于此实例的同伴实例的域名。

                        如果提供了 filter 参数，则将返回一个对象数组，每个对象都至少包含一个 `domain` 键。

                        被静音或被禁止的域名还将有一个包含 iso8601 date 格式字符串的 `suspended_at` 或 `silenced_at` 键。如果域名对象不包含这两个键，则它是开放的。在某些情况下，已被禁止的实例可能会被混淆，这意味着它们的一些字母将被 `*` 替换，以使恶意用户更难以针对实例进行骚扰。

                        无论返回的是扁平响应还是更详细的响应，域名都将按主机名字母顺序排序。                        
                    schema:
                        items:
                            $ref: '#/definitions/domain'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer: []
            tags:
                - instance
    /api/v1/instance/rules:
        get:
            description: 实例规则将按顺序返回（按 Order 升序排序）。
            operationId: rules
            produces:
                - application/json
            responses:
                "200":
                    description: 本站实例的所有规则组成的数组。
                    schema:
                        items:
                            $ref: '#/definitions/instanceRule'
                        type: array
                "400":
                    description: bad request 无效请求
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            summary: 查看实例规则(公开)
            tags:
                - instance
    /api/v1/interaction_policies/defaults:
        get:
            operationId: policiesDefaultsGet
            produces:
                - application/json
            responses:
                "200":
                    description: 一个默认的策略对象，包含每种贴文可见性的互动规则。
                    schema:
                        $ref: '#/definitions/defaultPolicies'
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取默认互动规则
            description: 获取你创建的新贴文的默认互动规则。
            tags:
                - interaction_policies
        patch:
            consumes:
                - multipart/form-data
                - application/x-www-form-urlencoded
                - application/json
            description: |-
                为你创建的不同可见性级别的新贴文更新默认互动策略。

                如果使用表单数据提交，请使用以下范式：

                `VISIBILITY[INTERACTION_TYPE][CONDITION][INDEX]=Value`

                例如：`public[can_reply][always][0]=author`

                使用 `curl` 调用时可以为如下形式：

                `curl -F 'public[can_reply][always][0]=author' -F 'public[can_reply][always][1]=followers'`

                其 JSON 等效形式为：

                `curl -H 'Content-Type: application/json' -d '{"public":{"can_reply":{"always":["author","followers"]}}}'`

                请求体中未指定的任何可见性级别将被重置为默认值。

                例如，在上面的示例中，“public” 将被更新，但“unlisted”、“private” 和“direct” 将被重置为默认值。

                服务器将对提交的策略执行一些规范化，以免您提交完全无效的策略。                
            operationId: policiesDefaultsUpdate
            parameters:
                - description: public.can_favourite.always 的第 N 个条目。
                  in: formData
                  name: public[can_favourite][always][0]
                  type: string
                - description: public.can_favourite.with_approval 的第 N 个条目。
                  in: formData
                  name: public[can_favourite][with_approval][0]
                  type: string
                - description: public.can_reply.always 的第 N 个条目。
                  in: formData
                  name: public[can_reply][always][0]
                  type: string
                - description: public.can_reply.with_approval 的第 N 个条目。
                  in: formData
                  name: public[can_reply][with_approval][0]
                  type: string
                - description: public.can_reblog.always 的第 N 个条目。
                  in: formData
                  name: public[can_reblog][always][0]
                  type: string
                - description: public.can_reblog.with_approval 的第 N 个条目。
                  in: formData
                  name: public[can_reblog][with_approval][0]
                  type: string
                - description: unlisted.can_favourite.always 的第 N 个条目。
                  in: formData
                  name: unlisted[can_favourite][always][0]
                  type: string
                - description: unlisted.can_favourite.with_approval 的第 N 个条目。
                  in: formData
                  name: unlisted[can_favourite][with_approval][0]
                  type: string
                - description: unlisted.can_reply.always 的第 N 个条目。
                  in: formData
                  name: unlisted[can_reply][always][0]
                  type: string
                - description: unlisted.can_reply.with_approval 的第 N 个条目。
                  in: formData
                  name: unlisted[can_reply][with_approval][0]
                  type: string
                - description: unlisted.can_reblog.always 的第 N 个条目。
                  in: formData
                  name: unlisted[can_reblog][always][0]
                  type: string
                - description: unlisted.can_reblog.with_approval 的第 N 个条目。
                  in: formData
                  name: unlisted[can_reblog][with_approval][0]
                  type: string
                - description: private.can_favourite.always 的第 N 个条目。
                  in: formData
                  name: private[can_favourite][always][0]
                  type: string
                - description: private.can_favourite.with_approval 的第 N 个条目。
                  in: formData
                  name: private[can_favourite][with_approval][0]
                  type: string
                - description: private.can_reply.always 的第 N 个条目。
                  in: formData
                  name: private[can_reply][always][0]
                  type: string
                - description: private.can_reply.with_approval 的第 N 个条目。
                  in: formData
                  name: private[can_reply][with_approval][0]
                  type: string
                - description: private.can_reblog.always 的第 N 个条目。
                  in: formData
                  name: private[can_reblog][always][0]
                  type: string
                - description: private.can_reblog.with_approval 的第 N 个条目。
                  in: formData
                  name: private[can_reblog][with_approval][0]
                  type: string
                - description: direct.can_favourite.always 的第 N 个条目。
                  in: formData
                  name: direct[can_favourite][always][0]
                  type: string
                - description: direct.can_favourite.with_approval 的第 N 个条目。
                  in: formData
                  name: direct[can_favourite][with_approval][0]
                  type: string
                - description: direct.can_reply.always 的第 N 个条目。
                  in: formData
                  name: direct[can_reply][always][0]
                  type: string
                - description: direct.can_reply.with_approval 的第 N 个条目。
                  in: formData
                  name: direct[can_reply][with_approval][0]
                  type: string
                - description: direct.can_reblog.always 的第 N 个条目。
                  in: formData
                  name: direct[can_reblog][always][0]
                  type: string
                - description: direct.can_reblog.with_approval 的第 N 个条目。
                  in: formData
                  name: direct[can_reblog][with_approval][0]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的默认策略对象，包含每种贴文可见性的互动规则。
                    schema:
                        $ref: '#/definitions/defaultPolicies'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 更新默认互动规则
            tags:
                - interaction_policies
    /api/v1/interaction_requests:
        get:
            description: |-
                获取其他账户对你的贴文发起的，等待你批准的互动请求的数组。
                ```
                <https://example.org/api/v1/interaction_requests?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/interaction_requests?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: getInteractionRequests
            parameters:
                - description: 若设置，则只有针对给定 status_id 的互动请求将包含在结果中。
                  in: query
                  name: status_id
                  type: string
                - default: true
                  description: 如果为 true 或未设置，则将在结果中包含待批准的点赞。favourites, replies 和 reblogs 中至少有一个必须为 true。
                  in: query
                  name: favourites
                  type: boolean
                - default: true
                  description: 如果为 true 或未设置，则将在结果中包含待批准的回复。favourites, replies 和 reblogs 中至少有一个必须为 true。
                  in: query
                  name: replies
                  type: boolean
                - default: true
                  description: 如果为 true 或未设置，则将在结果中包含待批准的转发。favourites, replies 和 reblogs 中至少有一个必须为 true。
                  in: query
                  name: reblogs
                  type: boolean
                - description: 仅返回比给定的 max ID *旧* 的互动请求。具有指定 ID 的互动请求不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的 since ID *新* 的互动请求。具有指定 ID 的互动请求不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回比给定的 min ID *相邻且更新* 的互动请求。具有指定 ID 的互动请求不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的互动请求数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/interactionRequest'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: 获取互动请求列表 
            tags:
                - interaction_requests
    /api/v1/interaction_requests/{id}:
        get:
            operationId: getInteractionRequest
            parameters:
                - description: 对你发出的互动请求的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 互动请求。
                    schema:
                        $ref: '#/definitions/interactionRequest'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: 获取单个互动请求
            description: 获取具有给定 ID 的互动请求。
            tags:
                - interaction_requests
    /api/v1/interaction_requests/{id}/authorize:
        post:
            operationId: authorizeInteractionRequest
            parameters:
                - description: 对你发出的互动请求的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被批准后的互动请求。
                    schema:
                        $ref: '#/definitions/interactionRequest'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 接受互动请求
            description: 接受/授权/批准具有给定 ID 的互动请求。
            tags:
                - interaction_requests
    /api/v1/interaction_requests/{id}/reject:
        post:
            operationId: rejectInteractionRequest
            parameters:
                - description: 对你发出的互动请求的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被拒绝的互动请求。
                    schema:
                        $ref: '#/definitions/interactionRequest'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 拒绝互动请求
            description: 拒绝具有给定 ID 的互动请求。
            tags:
                - interaction_requests
    /api/v1/lists:
        get:
            operationId: lists
            produces:
                - application/json
            responses:
                "200":
                    description: 发起请求的用户拥有的所有列表的数组。
                    schema:
                        items:
                            $ref: '#/definitions/list'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 获取所有列表
            description: 获取授权用户拥有的所有列表。
            tags:
                - lists
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: listCreate
            parameters:
                - description: |-
                    列表的标题。
                    示例: 大佬                    
                  in: formData
                  name: title
                  required: true
                  type: string
                  x-go-name: Title
                - default: list
                  description: |-
                    此列表的回复策略。
                    followed = 显示对任何关注的用户的回复
                    list = 显示对列表成员的回复
                    none = 不显示回复
                    示例: list                    
                  enum:
                    - followed
                    - list
                    - none
                  in: formData
                  name: replies_policy
                  type: string
                  x-go-name: RepliesPolicy
                - default: false
                  description: 将此列表的成员的贴文从你的主页时间线中隐藏。
                  in: formData
                  name: exclusive
                  type: boolean
                  x-go-name: Exclusive
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的列表。
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: 创建列表
            tags:
                - lists
    /api/v1/lists/{id}:
        delete:
            operationId: listDelete
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 列表已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: 删除列表
            description: 删除具有给定 ID 的列表。
            tags:
                - lists
        get:
            operationId: list
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的列表。
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 获取列表
            description: 获取具有给定 ID 的列表。
            tags:
                - lists
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: listUpdate
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    列表的标题。
                    示例: 大佬                    
                  in: formData
                  name: title
                  type: string
                - description: |-
                    列表的回复展示规则。
                    followed = 显示对任何关注的用户的回复
                    list = 显示对列表成员的回复
                    none = 不显示回复
                    示例: list                    
                  enum:
                    - followed
                    - list
                    - none
                  in: formData
                  name: replies_policy
                  type: string
                - description: 将此列表的成员的贴文从你的主页时间线中隐藏。
                  in: formData
                  name: exclusive
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的列表。
                    schema:
                        $ref: '#/definitions/list'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:lists
            summary: 更新列表
            tags:
                - lists
    /api/v1/lists/{id}/accounts:
        delete:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: removeListAccounts
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - collectionFormat: multi
                  description: 要编辑的账户 ID 数组。每个账户 ID 必须对应于一个发起请求的账户关注的账户。
                  in: formData
                  items:
                    type: string
                  name: account_ids[]
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 列表账户已更新
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 从列表删除账户
            description: 从给定列表中删除一个或多个账户。
            tags:
                - lists
        get:
            description: |-
                分页浏览给定列表中的账户。
                返回的 Link 标头可用于在时间线向上或向下滚动时生成上一个和下一个查询。

                示例:

                ```
                <https://example.org/api/v1/list/01H0W619198FX7J54NF7EH1NG2/accounts?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/list/01H0W619198FX7J54NF7EH1NG2/accounts?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: listAccounts
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 仅返回比给定的 max ID *旧* 的列表条目。具有指定 ID 的列表条目对应的账户不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的 since ID *新* 的列表条目。具有指定 ID 的列表条目对应的账户不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回比给定的 min ID *相邻且更新* 的列表条目。具有指定 ID 的列表条目对应的账户不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: '要返回的账户数量。如果显式设置为 0，则列表中的所有账户将被返回，并且不会使用分页标头。这是针对 Mastodon API 的一个特殊情况的解决方法：https://docs.joinmastodon.org/methods/lists/#query-parameters。'
                  in: query
                  maximum: 80
                  minimum: 0
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 账户数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 查看列表中的账户
            tags:
                - lists
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: addListAccounts
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - collectionFormat: multi
                  description: 要编辑的账户 ID 数组。每个账户 ID 必须对应于一个发起请求的账户关注的账户。
                  in: formData
                  items:
                    type: string
                  name: account_ids[]
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 列表账户已更新
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 向列表添加账户
            description: 向给定列表中添加一个或多个账户。
            tags:
                - lists
    /api/v1/markers:
        get:
            description: 根据名称获取时间线标记
            operationId: markersGet
            parameters:
                - description: 要检索的时间线。
                  in: query
                  items:
                    enum:
                        - home
                        - notifications
                    type: string
                  name: timeline
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的标记
                    schema:
                        $ref: '#/definitions/markers'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            tags:
                - markers
        post:
            consumes:
                - multipart/form-data
            description: 根据名称更新时间线标记
            operationId: markersPost
            parameters:
                - description: 在主页时间线上最后阅读的贴文 ID。
                  in: formData
                  name: home[last_read_id]
                  type: string
                - description: 在通知时间线上最后阅读的通知 ID。
                  in: formData
                  name: notifications[last_read_id]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的标记
                    schema:
                        $ref: '#/definitions/markers'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "409":
                    description: 冲突（当两个客户端尝试同时更新同一时间线时）
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            tags:
                - markers
    /api/v1/media/{id}:
        get:
            operationId: mediaGet
            parameters:
                - description: 附件的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的媒体附件。
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:media
            summary: 获取单个媒体附件
            description: 获取一个你拥有的媒体附件。
            tags:
                - media
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                你必须拥有这个媒体附件，并且这个附件还没有被附加到任何贴文上。

                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
                若 Content-Type 为 'application/xml'，则参数也可以在请求体中以 XML 形式给出。                
            operationId: mediaUpdate
            parameters:
                - description: 要更新的附件的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - allowEmptyValue: true
                  description: 图片或媒体描述，用作附件的 alt 文本。这对于使用屏幕阅读器的用户非常有用！根据实例设置，可能必填，也可能选填。
                  in: formData
                  name: description
                  type: string
                - allowEmptyValue: true
                  default: 0,0
                  description: '媒体文件的焦点。如果存在，它应该是两个介于 -1 和 1 之间的逗号分隔的浮点数。例如：`-0.5,0.25`。'
                  in: formData
                  name: focus
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的媒体附件。
                    schema:
                        $ref: '#/definitions/attachment'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:media
            summary: 更新单个媒体附件
            tags:
                - media
    /api/v1/mutes:
        get:
            description: |-
                获取发起请求的账户静音的账户列表。
                下一个和上一个查询可以从返回的Link标头中解析。
                示例:

                ```
                <https://example.org/api/v1/mutes?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/mutes?limit=80&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: mutesGet
            parameters:
                - description: '仅返回比给定的 max ID *旧* 的被静音账户。具有指定 ID 的被静音账户不会包含在响应中。'
                  in: query
                  name: max_id
                  type: string
                - description: '仅返回比给定的 since ID *新* 的被静音账户。具有指定 ID 的被静音账户不会包含在响应中。'
                  in: query
                  name: since_id
                  type: string
                - description: '仅返回比给定的 min ID *相邻且更新* 的被静音账户。具有指定 ID 的被静音账户不会包含在响应中。'
                  in: query
                  name: min_id
                  type: string
                - default: 40
                  description: 要返回的被静音账户数量。
                  in: query
                  maximum: 80
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 被静音账户的列表，包括他们的静音到期时间（如果适用）。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/mutedAccount'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:mutes
            summary: 获取静音账户列表
            tags:
                - mutes
    /api/v1/notification/{id}:
        get:
            operationId: notification
            parameters:
                - description: 通知的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的通知。
                    schema:
                        $ref: '#/definitions/notification'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: 获取单个通知
            description: 获取单个具有给定 ID 的通知。
            tags:
                - notifications
    /api/v1/notifications:
        get:
            description: |-
                获取当前授权用户的通知。
                通知将按照时间顺序（最新的在前）返回，具有连续的 ID（更大 = 更新）。

                下一个和上一个查询可以从返回的Link标头中解析。
                示例:

                ```
                <https://example.org/api/v1/notifications?limit=80&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/notifications?limit=80&since_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: notifications
            parameters:
                - description: 仅返回比给定的 max ID *旧* 的通知。具有指定 ID 的通知不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的 since ID *新* 的通知。具有指定 ID 的通知不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回比给定的 since ID *相邻且更新* 的通知。具有指定 ID 的通知不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的通知数量。
                  in: query
                  name: limit
                  type: integer
                - description: 要包含的通知类型。如果未提供，则将包含所有通知类型。
                  in: query
                  items:
                    enum:
                        - follow
                        - follow_request
                        - mention
                        - reblog
                        - favourite
                        - poll
                        - status
                        - admin.sign_up
                    type: string
                  name: types[]
                  type: array
                - description: 要排除的通知类型。
                  in: query
                  items:
                    enum:
                        - follow
                        - follow_request
                        - mention
                        - reblog
                        - favourite
                        - poll
                        - status
                        - admin.sign_up
                    type: string
                  name: exclude_types[]
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 通知数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/notification'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:notifications
            summary: 获取通知列表
            tags:
                - notifications
    /api/v1/notifications/clear:
        post:
            description: 清空/删除当前授权用户的所有通知。如果成功，将返回一个空对象 `{}`。
            operationId: clearNotifications
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        type: object
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:notifications
            summary: 清空通知
            tags:
                - notifications
    /api/v1/polls/{id}:
        get:
            operationId: poll
            parameters:
                - description: 目标投票 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的投票。
                    schema:
                        $ref: '#/definitions/poll'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 获取投票
            description: 获取具有给定 ID 的投票。
            tags:
                - polls
    /api/v1/polls/{id}/votes:
        post:
            operationId: pollVote
            parameters:
                - description: 目标投票 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 用户选择的投票项索引。
                  in: formData
                  items:
                    type: integer
                  name: choices
                  required: true
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的投票和用户投票选择。
                    schema:
                        $ref: '#/definitions/poll'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: unprocessable 无法处理 entity
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 参与投票
            description: 对给定投票进行投票。
            tags:
                - polls
    /api/v1/preferences:
        get:
            description: |-
                返回包含用户偏好设置的对象。
                示例:

                ```

                {
                "posting:default:visibility": "public",
                "posting:default:sensitive": false,
                "posting:default:language": "en",
                "reading:expand:media": "default",
                "reading:expand:spoilers": false,
                "reading:autoplay:gifs": false
                }

                ````                
            operationId: preferencesGet
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        type: object
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取用户偏好设置
            tags:
                - preferences
    /api/v1/profile/avatar:
        delete:
            description: 删除当前认证账户的头像。如果账户没有头像，调用也会成功。
            operationId: accountAvatarDelete
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的账户，包括个人资料源信息。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin
            summary: 删除头像
            tags:
                - accounts
    /api/v1/profile/header:
        delete:
            description: 删除当前认证账户的横幅背景头图。如果账户没有横幅背景头图，调用也会成功。
            operationId: accountHeaderDelete
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的账户，包括个人资料源信息。
                    schema:
                        $ref: '#/definitions/account'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin
            summary: 删除横幅背景
            tags:
                - accounts
    /api/v1/push/subscription:
        delete:
            operationId: pushSubscriptionDelete
            responses:
                "200":
                    description: 被删除的通知订阅，或不存在。
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - push
            summary: 删除 Web 推送订阅
            description: 删除当前访问令牌关联的网页推送订阅。即使没有订阅，也会返回成功。
            tags:
                - push
        get:
            operationId: pushSubscriptionGet
            produces:
                - application/json
            responses:
                "200":
                    description: 当前访问令牌的 Web 推送订阅。
                    schema:
                        $ref: '#/definitions/webPushSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: 当前访问令牌没有已关联的订阅。
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - push
            summary: 获取 Web 推送订阅
            description: 获取当前访问令牌关联的 Web 推送订阅。
            tags:
                - push
        post:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            operationId: pushSubscriptionPost
            parameters:
                - description: Web 推送订阅将要发往的端点。
                  in: formData
                  minLength: 1
                  name: subscription[endpoint]
                  required: true
                  type: string
                - description: 身份验证密钥,一个Base64编码的16字节随机数据字符串。
                  in: formData
                  minLength: 1
                  name: subscription[keys][auth]
                  required: true
                  type: string
                - description: 用户代理公钥，一个使用 prime256v1 曲线生成的 ECDH 密钥对的公钥的Base64编码字符串。
                  in: formData
                  minLength: 1
                  name: subscription[keys][p256dh]
                  required: true
                  type: string
                - default: false
                  description: 是否在有人关注你时接收推送通知？
                  in: formData
                  name: data[alerts][follow]
                  type: boolean
                - default: false
                  description: 是否在有人向你发送关注请求时接收推送通知？
                  in: formData
                  name: data[alerts][follow_request]
                  type: boolean
                - default: false
                  description: 是否在有人点赞你创建的贴文时接收推送通知？
                  in: formData
                  name: data[alerts][favourite]
                  type: boolean
                - default: false
                  description: 是否在有人在贴文中提及你时接收推送通知？
                  in: formData
                  name: data[alerts][mention]
                  type: boolean
                - default: false
                  description: 是否在有人转发你创建的贴文时接收推送通知？
                  in: formData
                  name: data[alerts][reblog]
                  type: boolean
                - default: false
                  description: 是否在你参与或创建的投票结束时接收通知？
                  in: formData
                  name: data[alerts][poll]
                  type: boolean
                - default: false
                  description: 是否在你订阅的某个账户发帖时接收推送通知？
                  in: formData
                  name: data[alerts][status]
                  type: boolean
                - default: false
                  description: 是否在你互动过的贴文被编辑时接收推送通知？
                  in: formData
                  name: data[alerts][update]
                  type: boolean
                - default: false
                  description: 是否在有新用户注册时接收推送通知？
                  in: formData
                  name: data[alerts][admin.sign_up]
                  type: boolean
                - default: false
                  description: 是否在有人提交新的举报时接收推送通知？
                  in: formData
                  name: data[alerts][admin.report]
                  type: boolean
                - default: false
                  description: 是否在有新的点赞待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.favourite]
                  type: boolean
                - default: false
                  description: 是否在有新的回复待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.reply]
                  type: boolean
                - default: false
                  description: 是否在有新的转发待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.reblog]
                  type: boolean
                - default: all
                  description: 接收推送通知的账号范围。
                  enum:
                    - all
                    - followed
                    - follower
                    - none
                  in: formData
                  name: data[policy]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 当前访问令牌关联的 Web 推送订阅。
                    schema:
                        $ref: '#/definitions/webPushSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - push
            summary: 创建 Web 推送订阅
            description: 使用当前访问令牌创建新的 Web 推送订阅，或替换现有订阅。
            tags:
                - push
        put:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            operationId: pushSubscriptionPut
            parameters:
                - default: false
                  description: 是否在有人关注你时接收推送通知？
                  in: formData
                  name: data[alerts][follow]
                  type: boolean
                - default: false
                  description: 是否在有人请求关注你时接收推送通知？
                  in: formData
                  name: data[alerts][follow_request]
                  type: boolean
                - default: false
                  description: 是否在有人点赞你创建的贴文时接收推送通知？
                  in: formData
                  name: data[alerts][favourite]
                  type: boolean
                - default: false
                  description: 是否在有人在贴文中提及你时接收推送通知？
                  in: formData
                  name: data[alerts][mention]
                  type: boolean
                - default: false
                  description: 是否在有人转发你创建的贴文时接收推送通知？
                  in: formData
                  name: data[alerts][reblog]
                  type: boolean
                - default: false
                  description: 是否在你参与或发起的投票结束时接收推送通知？
                  in: formData
                  name: data[alerts][poll]
                  type: boolean
                - default: false
                  description: 是否在你订阅的账号发帖时接收推送通知？
                  in: formData
                  name: data[alerts][status]
                  type: boolean
                - default: false
                  description: 是否在你互动过的贴文被编辑时接收推送通知？
                  in: formData
                  name: data[alerts][update]
                  type: boolean
                - default: false
                  description: 是否在有新用户注册时接收推送通知？
                  in: formData
                  name: data[alerts][admin.sign_up]
                  type: boolean
                - default: false
                  description: 是否在有新举报被提交时接收推送通知？
                  in: formData
                  name: data[alerts][admin.report]
                  type: boolean
                - default: false
                  description: 是否在有新点赞待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.favourite]
                  type: boolean
                - default: false
                  description: 是否在有新回复待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.reply]
                  type: boolean
                - default: false
                  description: 是否在有新转发待处理时接收推送通知？
                  in: formData
                  name: data[alerts][pending.reblog]
                  type: boolean
                - default: all
                  description: 接收推送通知的账号范围。
                  enum:
                    - all
                    - followed
                    - follower
                    - none
                  in: formData
                  name: data[policy]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 当前访问令牌关联的 Web 推送订阅。
                    schema:
                        $ref: '#/definitions/webPushSubscription'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - push
            summary: 更新 Web 推送订阅
            description: 更新当前访问令牌关联的 Web 推送订阅。仅更新要接收的通知范围。
            tags:
                - push
    /api/v1/reports:
        get:
            description: |-
                查看发起请求的账户创建的举报。

                举报将按时间顺序（最新的在前）返回，具有连续的 ID（更大 = 更新）。

                下一个和上一个查询可以从返回的Link标头中解析。

                示例:

                ```
                <https://example.org/api/v1/reports?limit=20&max_id=01FC0SKA48HNSVR6YKZCQGS2V8>; rel="next", <https://example.org/api/v1/reports?limit=20&min_id=01FC0SKW5JK2Q4EVAV2B462YY0>; rel="prev"
                ````                
            operationId: reports
            parameters:
                - description: 如果设置为 true，只返回已解决的举报。如果设置为 false，只返回未解决的举报。如果未设置，举报将不会根据其解决状态进行过滤。
                  in: query
                  name: resolved
                  type: boolean
                - description: 仅返回针对目标账户 ID 的举报。
                  in: query
                  name: target_account_id
                  type: string
                - description: 仅返回比给定的 max ID *旧* 的举报。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 仅返回比给定的 since ID *新* 的举报。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 仅返回比给定的 min ID *相邻且更新* 的举报。具有指定 ID 的举报不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的举报数量。
                  in: query
                  maximum: 100
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 举报的数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/report'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取举报列表
            tags:
                - reports
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: reportCreate
            parameters:
                - description: |-
                    要举报的账户 ID。
                    示例: 01GPE75FXSH2EGFBF85NXPH3KP                    
                  in: formData
                  name: account_id
                  required: true
                  type: string
                  x-go-name: AccountID
                - description: |-
                    要附加到举报中以提供额外上下文的贴文的 ID。
                    示例: ["01GPE76N4SBVRZ8K24TW51ZZQ4","01GPE76WN9JZE62EPT3Q9FRRD4"]                    
                  in: formData
                  items:
                    type: string
                  name: status_ids
                  type: array
                  x-go-name: StatusIDs
                - description: |-
                    举报的原因。默认最大 1000 个字符。
                    示例: 未经允许公开他人隐私信息                    
                  in: formData
                  name: comment
                  type: string
                  x-go-name: Comment
                - default: false
                  description: |-
                    如果账户为外站账户，是否应将举报转发给外站管理员？
                    示例: true                    
                  in: formData
                  name: forward
                  type: boolean
                  x-go-name: Forward
                - default: other
                  description: |-
                    指定举报属于骚扰、违反特定实例规则还是其他原因。
                    目前仅支持 'other'。
                    示例: other                    
                  in: formData
                  name: category
                  type: string
                  x-go-name: Category
                - description: |-
                    举报人提供的被违反的实例规则的 ID。
                    示例: ["01GPBN5YDY6JKBWE44H7YQBDCQ","01GPBN65PDWSBPWVDD0SQCFFY3"]                    
                  in: formData
                  items:
                    type: string
                  name: rule_ids
                  type: array
                  x-go-name: RuleIDs
            produces:
                - application/json
            responses:
                "200":
                    description: 创建的举报。
                    schema:
                        $ref: '#/definitions/report'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:reports
            summary: 创建举报
            description: 根据给定参数创建一个新的用户举报。
            tags:
                - reports
    /api/v1/reports/{id}:
        get:
            operationId: reportGet
            parameters:
                - description: 举报的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的举报。
                    schema:
                        $ref: '#/definitions/report'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取单条举报
            description: 获取具有给定 ID 的举报。
            tags:
                - reports
    /api/v1/statuses:
        post:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            description: |-
                按给定的表单字段参数创建一个新的贴文。
                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。

                `interaction_policy` 字段可用于为此贴文设置交互策略。

                如果使用表单数据提交，请使用以下模式设置交互策略：

                `interaction_policy[INTERACTION_TYPE][CONDITION][INDEX]=Value`

                例如：`interaction_policy[can_reply][always][0]=author`

                使用 `curl` 可以按如下所示：

                `curl -F 'interaction_policy[can_reply][always][0]=author' -F 'interaction_policy[can_reply][always][1]=followers' [... other form fields ...]`

                JSON 等效形式为：

                `curl -H 'Content-Type: application/json' -d '{"interaction_policy":{"can_reply":{"always":["author","followers"]}} [... other json fields ...]}'`

                服务器将对提交的策略执行一些规范化处理，以确保您无法提交完全无效的内容。                
            operationId: statusCreate
            parameters:
                - description: |-
                    贴文的文字内容。
                    如果提供了 media_ids，此项变为可选。
                    当提供贴文时，附加投票将变为可选。                    
                  in: formData
                  name: status
                  type: string
                  x-go-name: Status
                - collectionFormat: multi
                  description: |-
                    要附加的媒体附件 ID 数组。
                    如果提供了 media_ids，status 将变为可选，poll 不能使用。

                    如果贴文以表单形式提交，应使用的键为 'media_ids[]'，但如果是 JSON 或 XML，则键为 'media_ids'。                    
                  in: formData
                  items:
                    type: string
                  name: media_ids[]
                  type: array
                  uniqueItems: true
                  x-go-name: MediaIDs
                - collectionFormat: multi
                  description: |-
                    投票选项的数组。
                    如果提供了投票选项，media_ids 将不能使用，poll[expires_in] 必须提供。                    
                  in: formData
                  items:
                    type: string
                  name: poll[options][]
                  type: array
                  uniqueItems: true
                  x-go-name: PollOptions
                - description: |-
                    投票的开放时长，单位为秒。
                    如果提供了此项，media_ids 不能使用，poll[options] 必须提供。                    
                  format: int64
                  in: formData
                  name: poll[expires_in]
                  type: integer
                  x-go-name: PollExpiresIn
                - default: false
                  description: 在此投票上允许多选。
                  in: formData
                  name: poll[multiple]
                  type: boolean
                  x-go-name: PollMultiple
                - default: true
                  description: 在投票结束前隐藏投票计数。
                  in: formData
                  name: poll[hide_totals]
                  type: boolean
                  x-go-name: PollHideTotals
                - description: 被回复的贴文 ID（如果要发送的贴文是回复）。
                  in: formData
                  name: in_reply_to_id
                  type: string
                  x-go-name: InReplyToID
                - description: 贴文和附加媒体应标记为敏感。
                  in: formData
                  name: sensitive
                  type: boolean
                  x-go-name: Sensitive
                - description: |-
                    在贴文内容之前显示的警告或主题文本。
                    贴文通常被折叠在此字段身后。                    
                  in: formData
                  name: spoiler_text
                  type: string
                  x-go-name: SpoilerText
                - description: 贴文的可见性。
                  enum:
                    - public
                    - unlisted
                    - private
                    - mutuals_only
                    - direct
                  in: formData
                  name: visibility
                  type: string
                  x-go-name: Visibility
                - default: false
                  description: 如果设置为 true，此状态将仅在本站可见，不会传播到本站以外的时间线。如果设置为 false（默认），此状态将传播到您的所有关注者，以及本站时间线外的时间线。
                  in: formData
                  name: local_only
                  type: boolean
                  x-go-name: LocalOnly
                - description: '***已弃用***。仅用于后向兼容。仅在 local_only 尚未设置且此字段被明确设置时使用。如果设置为 true，此贴文将在本站时间线之外传播。如果设置为 false，此贴文将不会在本站时间线之外传播。'
                  in: formData
                  name: federated
                  type: boolean
                  x-go-name: Federated
                - description: |-
                    此贴文的计划发布时间，格式为 ISO 8601 Datetime。
                    如果使用 *未来* 的时间设置该参数，将返回 ScheduledStatus 而不是 Status。
                    且时间必须至少在当前时间之后 5 分钟。
                    此功能尚未实现。

                    如果使用 *过去* 的时间设置该参数，则对应的帖文将被标记为历史帖文，
                    且不会推送给用户的关注者。这主要用于导入旧帖文。                    
                  format: date-time
                  in: formData
                  name: scheduled_at
                  type: string
                  x-go-name: ScheduledAt
                - description: 此贴文的 ISO 639 语言代码。
                  in: formData
                  name: language
                  type: string
                  x-go-name: Language
                - description: 解析此贴文时使用的内容格式。
                  enum:
                    - text/plain
                    - text/markdown
                  in: formData
                  name: content_type
                  type: string
                  x-go-name: ContentType
                - description: interaction_policy.can_favourite.always 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_favourite][always][0]
                  type: string
                - description: interaction_policy.can_favourite.with_approval 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_favourite][with_approval][0]
                  type: string
                - description: interaction_policy.can_reply.always 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_reply][always][0]
                  type: string
                - description: interaction_policy.can_reply.with_approval 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_reply][with_approval][0]
                  type: string
                - description: interaction_policy.can_reblog.always 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_reblog][always][0]
                  type: string
                - description: interaction_policy.can_reblog.with_approval 的第 N 个条目。
                  in: formData
                  name: interaction_policy[can_reblog][with_approval][0]
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新创建的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
                "501":
                    description: scheduled_at 被设置，但此功能尚未实现
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 创建新贴文
            tags:
                - statuses
        put:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            operationId: statusEdit
            parameters:
                - description: 要编辑的贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    贴文的文本内容。
                    如果提供了 media_ids，此项变为可选。
                    如果提供了文本内容，则投票（poll）也变为可选。                    
                  in: formData
                  name: status
                  type: string
                  x-go-name: Status
                - description: |-
                    要附加的媒体附件 ID 数组。
                    如果提供了 media_ids，status 将变为可选，poll 不能使用。

                    如果贴文以表单形式提交，应使用的键为 'media_ids[]'，但如果是 JSON 或 XML，则键为 'media_ids'。                    
                  in: formData
                  items:
                    type: string
                  name: media_ids
                  type: array
                  x-go-name: MediaIDs
                - description: |-
                    投票选项的数组。
                    如果提供了投票选项，media_ids 将不能使用，poll[expires_in] 必须提供。                    
                  in: formData
                  items:
                    type: string
                  name: poll[options][]
                  type: array
                  x-go-name: PollOptions
                - description: |-
                    投票的开放时长，单位为秒。
                    如果提供了此项，media_ids 不能使用，poll[options] 必须提供。                    
                  format: int64
                  in: formData
                  name: poll[expires_in]
                  type: integer
                  x-go-name: PollExpiresIn
                - default: false
                  description: 在此投票上允许多选。
                  in: formData
                  name: poll[multiple]
                  type: boolean
                  x-go-name: PollMultiple
                - default: true
                  description: 在投票结束前隐藏投票计数。
                  in: formData
                  name: poll[hide_totals]
                  type: boolean
                  x-go-name: PollHideTotals
                - description: 贴文和媒体附件应被标记为敏感。
                  in: formData
                  name: sensitive
                  type: boolean
                  x-go-name: Sensitive
                - description: |-
                    在贴文内容之前显示的警告或主题文本。
                    贴文通常被折叠在此字段后。                    
                  in: formData
                  name: spoiler_text
                  type: string
                  x-go-name: SpoilerText
                - description: 此贴文的 ISO 639 语言代码。
                  in: formData
                  name: language
                  type: string
                  x-go-name: Language
                - description: 解析此贴文时使用的内容格式。
                  enum:
                    - text/plain
                    - text/markdown
                  in: formData
                  name: content_type
                  type: string
                  x-go-name: ContentType
            produces:
                - application/json
            responses:
                "200":
                    description: 此贴文的最新版本。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 编辑贴文
            description: 按给定的表单参数编辑某条现有贴文。如果 content-type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
            tags:
                - statuses
    /api/v1/statuses/{id}:
        delete:
            description: |-
                删除给定 ID 的贴文。贴文必须属于调用API的用户。
                删除的贴文将在响应中返回。`text` 字段将包含贴文的原始文本，就像它被提交时一样。这在执行“删除并重新撰写”类型操作时很有用。                
            operationId: statusDelete
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 刚刚被删除的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 删除贴文
            tags:
                - statuses
        get:
            operationId: statusGet
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看贴文
            description: 查看具有给定 ID 的贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/bookmark:
        post:
            operationId: statusBookmark
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 对应的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:bookmarks
            summary: 收藏贴文
            description: 收藏具有给定 ID 的贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/context:
        get:
            description: 返回给定贴文的祖先和后代。返回的贴文将按贴文串结构排序，因此它们适合按返回顺序显示。
            operationId: threadContext
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文串上下文对象。
                    schema:
                        $ref: '#/definitions/threadContext'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看贴文串上下文
            tags:
                - statuses
    /api/v1/statuses/{id}/favourite:
        post:
            operationId: statusFave
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被点赞的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 点赞贴文
            description: 点赞给定 ID 的贴文（如果允许）。
            tags:
                - statuses
    /api/v1/statuses/{id}/favourited_by:
        get:
            operationId: statusFavedBy
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看贴文点赞列表
            description: 查看点赞给定 ID 的贴文的账户。
            tags:
                - statuses
    /api/v1/statuses/{id}/history:
        get:
            description: '查看给定 ID 的贴文的编辑历史。'
            operationId: statusHistoryGet
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/statusEdit'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看贴文编辑历史 
            tags:
                - statuses
    /api/v1/statuses/{id}/mute:
        post:
            description: |-
                静音某条贴文的贴文串，防止未来串中的回复、点赞、转发等行为产生通知。

                目标贴文必须属于您或提及了您。

                贴文串静音和取消静音是幂等的。如果您已经静音了一个串，再次静音它只是意味着它保持静音，您将得到 200 OK 返回。                
            operationId: statusMute
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被静音的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求; 你不是目标贴文串的参与者
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: 静音贴文串
            tags:
                - statuses
    /api/v1/statuses/{id}/pin:
        post:
            description: |-
                将贴文在个人资料页置顶，并将其添加到你的特色 ActivityPub 集合中。

                你只能将原创贴文（非转发）固定到自己的个人资料上。

                支持的固定贴文的隐私级别有 public、unlisted 和 private/followers-only，
                但只有公开贴文会出现在您个人资料的网页版本上。                
            operationId: statusPin
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被固定的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 置顶贴文
            tags:
                - statuses
    /api/v1/statuses/{id}/reblog:
        post:
            description: |-
                转发给定 ID 的贴文。
                如果目标贴文是可转发的，它将被分享给您的粉丝。
                这相当于一个 ActivityPub 'Announce' 活动。                
            operationId: statusReblog
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被转发的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 转发贴文
            tags:
                - statuses
    /api/v1/statuses/{id}/reblogged_by:
        get:
            operationId: statusBoostedBy
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/account'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看贴文转发列表
            description: 查看转发给定 ID 的贴文的账户。
            tags:
                - statuses
    /api/v1/statuses/{id}/source:
        get:
            operationId: statusSourceGet
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    schema:
                        items:
                            $ref: '#/definitions/statusSource'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看贴文源文本
            description: 查看给定 ID 的贴文的源文本。请求者必须拥有该贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/unbookmark:
        post:
            operationId: statusUnbookmark
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 对应的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:bookmarks
            summary: 取消收藏贴文
            description: 取消收藏给定 ID 的贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/unfavourite:
        post:
            operationId: statusUnfave
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被取消点赞的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:favourites
            summary: 取消点赞贴文
            description: 取消点赞给定 ID 的贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/unmute:
        post:
            description: |-
                取消静音某条贴文的贴文串。这将重新启用串中未来回复、点赞、转发等行为的通知。

                目标贴文必须属于您或提及了您。

                贴文串静音和取消静音是幂等的。如果您已经取消静音了一个串，再次取消静音它只是意味着它保持取消静音，您将得到 200 OK 的返回状态。                
            operationId: statusUnmute
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被取消静音的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求; 你不是目标贴文串的参与者
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:mutes
            summary: 取消静音贴文串
            tags:
                - statuses
    /api/v1/statuses/{id}/unpin:
        post:
            operationId: statusUnpin
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 取消置顶贴文
            description: 取消置顶某条已经置顶的贴文。
            tags:
                - statuses
    /api/v1/statuses/{id}/unreblog:
        post:
            operationId: statusUnreblog
            parameters:
                - description: 目标贴文 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被取消转发的贴文。
                    schema:
                        $ref: '#/definitions/status'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:statuses
            summary: 取消转发贴文
            description: 取消转发给定 ID 的贴文。
            tags:
                - statuses
    /api/v1/streaming:
        get:
            description: |-
                发起一个用于实时流式传输贴文和通知的 websocket 连接。
                使用的协议应始终为 `wss`。流式传输根路径可以在 `/api/v1/instance` 查看。

                在成功连接时，将返回代码 `101`，表示正在将连接升级为安全的 websocket 连接。

                只要连接保持打开状态，就会将各种消息类型流式传输到其中。

                GoToSocial 将每 30 秒对连接进行 ping，以检查客户端是否仍在接收。

                如果 ping 失败，或者在传输过程中发生其他问题，则连接将被断开，并且客户端将被要求重新启动。                
            operationId: streamGet
            parameters:
                - description: 发起请求的账户的访问令牌。
                  in: query
                  name: access_token
                  required: true
                  type: string
                - description: |-
                    请求的流类型。

                    可用选项有：

                    `user`: 接收账户的主页时间线更新。
                    `public`: 接收公共时间线更新。
                    `public:local`: 接收本站时间线更新。
                    `hashtag`: 接收给定话题标签的更新。
                    `hashtag:local`: 接收给定话题标签的本站更新。
                    `list`: 接收一个列表中的账户的更新。
                    `direct`: 接收私信的更新。                    
                  in: query
                  name: stream
                  required: true
                  type: string
                - description: |-
                    要订阅的列表的 ID。
                    仅在流类型为 'list' 时使用。                    
                  in: query
                  name: list
                  type: string
                - description: |-
                    要订阅的话题标签的名称。
                    仅在流类型为 'hashtag' 或 'hashtag:local' 时使用。                    
                  in: query
                  name: tag
                  type: string
            produces:
                - application/json
            responses:
                "101":
                    description: ""
                    schema:
                        properties:
                            event:
                                description: |-
                                    要接收的事件类型。

                                    `update`：收到新贴文。
                                    `notification`：收到新通知。
                                    `delete`：贴文已被删除。
                                    `filters_changed`：过滤规则（包括关键字和贴文）已更改。                                    
                                enum:
                                    - update
                                    - notification
                                    - delete
                                    - filters_changed
                                type: string
                            payload:
                                description: |-
                                    流式传输消息的有效负载。
                                    根据 `event` 类型不同而不同。

                                    如果存在，应解析为字符串。

                                    如果 `event` = `update`，则负载将是一个贴文的 JSON 字符串。
                                    如果 `event` = `notification`，则负载将是一个通知的 JSON 字符串。
                                    如果 `event` = `delete`，则负载将是一个贴文 ID。
                                    如果 `event` = `filters_changed`，则没有负载。                                    
                                example: '{"id":"01FC3TZ5CFG6H65GCKCJRKA669","created_at":"2021-08-02T16:25:52Z","sensitive":false,"spoiler_text":"","visibility":"public","language":"en","uri":"https://gts.superseriousbusiness.org/users/dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669","url":"https://gts.superseriousbusiness.org/@dumpsterqueer/statuses/01FC3TZ5CFG6H65GCKCJRKA669","replies_count":0,"reblogs_count":0,"favourites_count":0,"favourited":false,"reblogged":false,"muted":false,"bookmarked":fals…//gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/original/019036W043D8FXPJKSKCX7G965.png","header_static":"https://gts.superseriousbusiness.org/fileserver/01JNN207W98SGG3CBJ76R5MVDN/header/small/019036W043D8FXPJKSKCX7G965.png","followers_count":33,"following_count":28,"statuses_count":126,"last_status_at":"2021-08-02T16:25:52Z","emojis":[],"fields":[]},"media_attachments":[],"mentions":[],"tags":[],"emojis":[],"card":null,"poll":null,"text":"a"}'
                                type: string
                            stream:
                                items:
                                    enum:
                                        - user
                                        - public
                                        - public:local
                                        - hashtag
                                        - hashtag:local
                                        - list
                                        - direct
                                    type: string
                                type: array
                        type: object
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            schemes:
                - wss
            security:
                - OAuth2 Bearer:
                    - read:streaming
            summary: 流式传输
            tags:
                - streaming
    /api/v1/tags/{tag_name}:
        get:
            description: 获取话题标签详情，包括您当前是否关注它。如果话题不存在，此方法不会在数据库中创建它。
            operationId: getTag
            parameters:
                - description: 话题标签的名称（不包含 `#`）。
                  in: path
                  name: tag_name
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 话题标签详情。
                    schema:
                        $ref: '#/definitions/tag'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer: []
            summary: 获取话题标签
            tags:
                - tags
    /api/v1/tags/{tag_name}/follow:
        post:
            description: '此端点是幂等的：如果您已经关注了话题标签，此调用仍将成功。'
            operationId: followTag
            parameters:
                - description: 话题标签的名称（不包含 `#`）。
                  in: path
                  name: tag_name
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 话题标签详情。
                    schema:
                        $ref: '#/definitions/tag'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 关注话题标签
            tags:
                - tags
    /api/v1/tags/{tag_name}/unfollow:
        post:
            description: '此端点是幂等的：如果您没有关注话题标签，此调用仍将成功。'
            operationId: unfollowTag
            parameters:
                - description: 话题标签的名称（不包含 `#`）。
                  in: path
                  name: tag_name
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 话题标签详情。
                    schema:
                        $ref: '#/definitions/tag'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: unauthorized 未授权
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:follows
            summary: 取消关注话题标签
            tags:
                - tags
    /api/v1/timelines/home:
        get:
            description: |-
                查看你关注的账户发布的贴文。
                贴文将按时间顺序（最新的在前）返回，带有连续的 ID（较大 = 较新）。

                返回的 Link 标头可用于在时间线向上或向下滚动时生成上一个和下一个查询。

                示例:

                ```
                <https://example.org/api/v1/timelines/home?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/home?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: homeTimeline
            parameters:
                - description: 只返回早于给定的最大贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回新于给定的最小贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的最小贴文 ID **相邻且更新** 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: 仅显示本站账户发布的贴文。
                  in: query
                  name: local
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看主页时间线
            tags:
                - timelines
    /api/v1/timelines/list/{id}:
        get:
            description: |-
                查看给定列表的时间线贴文。

                贴文将按时间顺序（最新的在前）返回，带有连续的 ID（较大 = 较新）。

                返回的 Link 标头可用于在时间线向上或向下滚动时生成上一个和下一个查询。

                示例:

                ```
                <https://example.org/api/v1/timelines/list/01H0W619198FX7J54NF7EH1NG2?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/list/01H0W619198FX7J54NF7EH1NG2?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: listTimeline
            parameters:
                - description: 列表的 ID
                  in: path
                  name: id
                  required: true
                  type: string
                - description: 只返回早于给定的最大贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回新于给定的最小贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的最小贴文 ID **相邻且更新** 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            security:
                - OAuth2 Bearer:
                    - read:lists
            summary: 查看列表时间线
            tags:
                - timelines
    /api/v1/timelines/public:
        get:
            description: |-
                查看你所在的实例已知的公开贴文。

                贴文将按时间顺序（最新的在前）返回，带有连续的 ID（较大 = 较新）。

                返回的 Link 标头可用于在时间线向上或向下滚动时生成上一个和下一个查询。

                示例:

                ```
                <https://example.org/api/v1/timelines/public?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/public?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: publicTimeline
            parameters:
                - description: 只返回早于给定的最大贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回新于给定的最小贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的最小贴文 ID **相邻且更新** 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的贴文数量。
                  in: query
                  name: limit
                  type: integer
                - default: false
                  description: 仅显示本站账户发布的贴文。
                  in: query
                  name: local
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看跨站时间线
            tags:
                - timelines
    /api/v1/timelines/tag/{tag_name}:
        get:
            description: |-
                查看给定话题标签的公开贴文 (不区分大小写)

                贴文将按时间顺序（最新的在前）返回，带有连续的 ID（较大 = 较新）。

                返回的 Link 标头可用于在时间线向上或向下滚动时生成上一个和下一个查询。

                示例:

                ```
                <https://example.org/api/v1/timelines/tag/example?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/timelines/tag/example?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: tagTimeline
            parameters:
                - description: Name of the tag
                  in: path
                  name: tag_name
                  required: true
                  type: string
                - description: 只返回早于给定的最大贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回新于给定的最小贴文 ID 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的最小贴文 ID **相邻且更新** 的贴文。具有指定 ID 的贴文不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的贴文数量。
                  in: query
                  maximum: 40
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 贴文数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/status'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            security:
                - OAuth2 Bearer:
                    - read:statuses
            summary: 查看话题标签时间线
            tags:
                - timelines
    /api/v1/tokens:
        get:
            description: |-
                查看由/为你的账户创建的令牌的相关信息。

                条目将按时间降序返回（最新的在前），并带有顺序 ID（数值越大表示越新）。

                返回的 Link 标头可用于在向上或向下翻页时生成上一页和下一页的查询。

                例如：


                ```
                <https://example.org/api/v1/tokens?limit=20&max_id=01FC3GSQ8A3MMJ43BPZSGEG29M>; rel="next", <https://example.org/api/v1/tokens?limit=20&min_id=01FC3KJW2GYXSDDRA6RWNDM46M>; rel="prev"
                ````                
            operationId: tokensInfoGet
            parameters:
                - description: 只返回早于给定的最大令牌 ID 的令牌。具有给定 ID 的令牌不会包含在响应中。
                  in: query
                  name: max_id
                  type: string
                - description: 只返回新于给定的最小令牌 ID 的令牌。具有给定 ID 的令牌不会包含在响应中。
                  in: query
                  name: since_id
                  type: string
                - description: 只返回比给定的最小令牌 ID **相邻且更新** 的令牌。具有指定 ID 的令牌不会包含在响应中。
                  in: query
                  name: min_id
                  type: string
                - default: 20
                  description: 要返回的令牌数量。
                  in: query
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: 令牌详情数组。
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/tokenInfo'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看令牌列表
            tags:
                - tokens
    /api/v1/tokens/{id}:
        get:
            operationId: tokenInfoGet
            parameters:
                - description: 要查询的令牌 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 要查询的令牌。
                    schema:
                        $ref: '#/definitions/tokenInfo'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务端内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取单个令牌的信息
            tags:
                - tokens
    /api/v1/tokens/{id}/invalidate:
        post:
            operationId: tokenInvalidatePost
            parameters:
                - description: 要禁用的令牌 ID。
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 被禁用的令牌信息。
                    schema:
                        $ref: '#/definitions/tokenInfo'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务端内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 禁用单个令牌
            description: 禁用单个令牌，从数据库中删除并使其无法使用。
            tags:
                - tokens
    /api/v1/user:
        get:
            operationId: getUser
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的用户。
                    schema:
                        $ref: '#/definitions/user'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal error
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 获取当前用户
            description: 获取自己的用户模型。
            tags:
                - user
    /api/v1/user/2fa/disable:
        post:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            description: |-
                如果双因素验证已被禁用，将返回 409 Conflict。

                如果实例正在运行 OIDC，那么将无法在 GtS 中启用或禁用双因素验证，必须在 OIDC 提供商处启用或禁用。所有对双因素验证 API 端点的调用在 OIDC 启用时将返回 422 Unprocessable Entity。                
            operationId: TwoFactorDisablePost
            parameters:
                - description: 用户的当前密码，用于验证。
                  in: formData
                  name: password
                  type: string
            responses:
                "200":
                    description: 二维码
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "422":
                    description: unprocessable entity 无法处理
                "500":
                    description: internal error 内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 禁用双因素验证
            description: 为当前用户禁用双因素验证，必须提供用户当前密码用于验证。
            tags:
                - user
    /api/v1/user/2fa/enable:
        post:
            consumes:
                - application/json
                - application/x-www-form-urlencoded
            description: |-
                如果双因素验证已被启用，将返回 409 Conflict。

                如果实例正在运行 OIDC，那么将无法在 GtS 中启用或禁用双因素验证，必须在 OIDC 提供商处启用或禁用。所有对双因素验证 API 端点的调用在 OIDC 启用时将返回 422 Unprocessable Entity。                
            operationId: TwoFactorEnablePost
            parameters:
                - description: |-
                    用户的双因素验证代码。
                    示例：123456                    
                  in: formData
                  name: code
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 二维码
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "422":
                    description: unprocessable entity 无法处理
                "500":
                    description: internal error 内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 启用双因素验证
            description: 为当前用户启用双因素验证，使用验证器应用提供的代码，返回一个一次性恢复代码数组，以允许绕过双因素验证。
            tags:
                - user
    /api/v1/user/2fa/qr.png:
        get:
            description: |-
                若希望获取二维码 URI 的明文版本，请调用 /api/v1/user/2fa/qruri 接口。

                若用户已经启用了双因素认证，将不会再次分享二维码（及其密钥）。反之，会返回 409 Conflict 错误。要获取新的密钥，请先使用 POST /api/v1/user/2fa/disable 接口禁用双因素认证，然后再调用此接口。

                若实例启用了 OIDC，则无法在 GtS 中开启或关闭双因素认证，必须使用 OIDC 提供商进行启用或禁用。在启用 OIDC 期间，所有对 2fa API 接口的调用都将返回 422 Unprocessable Entity 错误。                
            operationId: TwoFactorQRCodePngGet
            produces:
                - image/png
            responses:
                "200":
                    description: 二维码 PNG 图片
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "422":
                    description: unprocessable entity 无法处理
                "500":
                    description: internal error 内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看用于启用双因素认证的二维码
            description: 返回一个二维码 PNG 图片，允许对应用户启用双因素认证。
            tags:
                - user
    /api/v1/user/2fa/qruri:
        get:
            description: |-
                若需要 PNG 格式的二维码，请调用 /api/v1/user/2fa/qr.png 接口。

                若用户已经启用了双因素验证，将不会再次分享二维码（及其密钥）。反之，会返回 409 Conflict 错误。要获取新的密钥，请先使用 POST /api/v1/user/2fa/disable 接口禁用双因素验证，然后再调用此接口。

                若实例启用了 OIDC，则无法在 GtS 中开启或关闭双因素验证，必须使用 OIDC 提供商进行启用或禁用。在启用 OIDC 期间，所有对双因素验证 API 接口的调用都将返回 422 Unprocessable Entity 错误。                
            operationId: TwoFactorQRCodeURIGet
            produces:
                - text/plain
            responses:
                "200":
                    description: 二维码 URI
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突
                "422":
                    description: unprocessable entity 无法处理
                "500":
                    description: internal error 内部错误
            security:
                - OAuth2 Bearer:
                    - read:accounts
            summary: 查看用于启用双因素验证的二维码 URI
            description: 返回一个二维码 URI，允许对应用户启用双因素验证。
            tags:
                - user
    /api/v1/user/email_change:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: userEmailChange
            parameters:
                - description: 用户当前密码，用于验证。
                  in: formData
                  name: password
                  required: true
                  type: string
                  x-go-name: Password
                - description: 新邮箱地址。
                  in: formData
                  name: new_email
                  required: true
                  type: string
                  x-go-name: NewEmail
            produces:
                - application/json
            responses:
                "202":
                    description: '已接受：正在处理邮箱更改；请检查您的收件箱以确认新地址。'
                    schema:
                        $ref: '#/definitions/user'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: '冲突: 提供的邮箱地址已被使用'
                "500":
                    description: internal error 服务端内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 更改邮箱地址
            description: 请求更改当前用户的邮箱地址。
            tags:
                - user
    /api/v1/user/password_change:
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                修改当前用户的密码。
                若 Content-Type 为 'application/json'，则参数也可以在请求体中以 JSON 形式给出。
                若 Content-Type 为 'application/xml'，则参数也可以在请求体中以 XML 形式给出。                
            operationId: userPasswordChange
            parameters:
                - description: 用户的旧密码。
                  in: formData
                  name: old_password
                  required: true
                  type: string
                  x-go-name: OldPassword
                - description: |-
                    用户提供的新密码。
                    如果密码的熵不够高，将被拒绝。
                    参见 https://github.com/wagslane/go-password-validator                    
                  in: formData
                  name: new_password
                  required: true
                  type: string
                  x-go-name: NewPassword
            produces:
                - application/json
            responses:
                "200":
                    description: 密码更改成功
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "406":
                    description: not acceptable 不可接受
                "422":
                    description: 无法处理请求，因为实例正在使用 OIDC 后端
                "500":
                    description: internal error 服务端内部错误
            security:
                - OAuth2 Bearer:
                    - write:accounts
            summary: 更改密码
            tags:
                - user
    /api/v2/admin/accounts:
        get:
            description: |-
                按给定过滤规则查看并按页浏览已知账户。

                返回的账户将按域名 + 用户名的字母顺序（a-z）排序。

                下一个和上一个查询可以从返回的Link标头中解析。
                示例:

                ```
                <https://example.org/api/v2/admin/accounts?limit=80&max_id=example.org%2F%40someone>; rel="next", <https://example.org/api/v2/admin/accounts?limit=80&min_id=example.org%2F%40someone_else>; rel="prev"
                ````                
            operationId: adminAccountsGetV2
            parameters:
                - description: 针对 `local` 或 `remote` 类型的账户进行过滤。
                  in: query
                  name: origin
                  type: string
                - description: 针对 `active`, `pending`, `disabled`, `silenced`, 或 `suspended` 类型的账户进行过滤。
                  in: query
                  name: status
                  type: string
                - description: 针对具有站务权限（可以管理举报）的账户进行过滤。
                  in: query
                  name: permissions
                  type: string
                - description: 针对具有对应身份组的账户进行过滤。
                  in: query
                  items:
                    type: string
                  name: role_ids[]
                  type: array
                - description: 查找被对应 ID 的账户邀请的用户。
                  in: query
                  name: invited_by
                  type: string
                - description: 搜索给定用户名。
                  in: query
                  name: username
                  type: string
                - description: 搜索给定昵称。
                  in: query
                  name: display_name
                  type: string
                - description: 针对给定实例域名进行过滤。
                  in: query
                  name: by_domain
                  type: string
                - description: 查找具有给定电子邮箱的用户。
                  in: query
                  name: email
                  type: string
                - description: 查找具有此 IP 地址的用户。
                  in: query
                  name: ip
                  type: string
                - description: "`[domain]/@[username]` 形式的 max_id。返回的所有结果都将在 `[domain]/@[username]` 之后的字母顺序中。例如，如果 max_id = `example.org/@someone`，则返回的条目可能包含 `example.org/@someone_else`，`later.example.org/@someone` 等。本站账户 ID 使用空字符串作为 `[domain]` 部分，例如具有用户名 `someone` 的本站账户将是 `/@someone`。"
                  in: query
                  name: max_id
                  type: string
                - description: "`[domain]/@[username]` 形式的 min_id。返回的所有结果都将在 `[domain]/@[username]` 之前的字母顺序中。例如，如果 min_id = `example.org/@someone`，则返回的条目可能包含 `example.org/@earlier_account`，`earlier.example.org/@someone` 等。本站账户 ID 使用空字符串作为 `[domain]` 部分，例如具有用户名 `someone` 的本站账户将是 `/@someone`。"
                  in: query
                  name: min_id
                  type: string
                - default: 50
                  description: 返回的最大结果数量。
                  in: query
                  maximum: 200
                  minimum: 1
                  name: limit
                  type: integer
            produces:
                - application/json
            responses:
                "200":
                    description: ""
                    headers:
                        Link:
                            description: 下一/上一查询的链接。
                            type: string
                    schema:
                        items:
                            $ref: '#/definitions/adminAccountInfo'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - admin:read:accounts
            summary: 查看账户列表
            tags:
                - admin
    /api/v2/filters:
        get:
            operationId: filtersV2Get
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则。
                    schema:
                        items:
                            $ref: '#/definitions/filterV2'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取V2过滤规则
            description: 获取当前账户的所有V2过滤规则。
            tags:
                - filters
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterV2Post
            parameters:
                - description: |-
                    过滤规则的名称。

                    示例： 挂人                    
                  in: formData
                  maxLength: 200
                  minLength: 1
                  name: title
                  required: true
                  type: string
                - collectionFormat: multi
                  description: |-
                    此过滤规则要应用的上下文。

                    示例: home, public                    
                  in: formData
                  items:
                    enum:
                      - home
                      - notifications
                      - public
                      - thread
                      - account
                    type: string
                  minItems: 1
                  name: context[]
                  required: true
                  type: array
                  uniqueItems: true
                - description: |-
                    此过滤规则的持续时间（以秒为单位）。若省略，则过滤规则永不过期。

                    示例：86400                    
                  in: formData
                  name: expires_in
                  type: number
                - default: warn
                  description: |-
                    贴文命中过滤规则时的操作。

                    示例: warn                    
                  enum:
                    - warn
                    - hide
                  in: formData
                  name: filter_action
                  type: string
                - collectionFormat: multi
                  description: 要添加 (如果不使用 id 参数) 或更新 (如果使用 id 参数) 的关键词。
                  in: formData
                  items:
                    type: string
                  name: keywords_attributes[][keyword]
                  type: array
                - collectionFormat: multi
                  description: 匹配关键词时是否考虑单词边界 (整词匹配)？
                  in: formData
                  items:
                    type: boolean
                  name: keywords_attributes[][whole_word]
                  type: array
                - collectionFormat: multi
                  description: 要添加到过滤规则的贴文（status）。
                  in: formData
                  items:
                    type: string
                  name: statuses_attributes[][status_id]
                  type: array
            produces:
                - application/json
            responses:
                "200":
                    description: 新过滤规则。
                    schema:
                        $ref: '#/definitions/filterV2'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突（重复的标题、关键词或贴文）
                "422":
                    description: 无法处理的内容
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 创建V2过滤规则
            tags:
                - filters
    /api/v2/filters/{id}:
        delete:
            operationId: filterV2Delete
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 过滤规则已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 删除V2过滤规则
            description: 删除给定 ID 的单个V2过滤规则。
            tags:
                - filters
        get:
            operationId: filterV2Get
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则。
                    schema:
                        $ref: '#/definitions/filterV2'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取单个V2过滤规则
            description: 获取给定 ID 的单个V2过滤规则。
            tags:
                - filters
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            description: |-
                更新具有给定 ID 的单个V2过滤规则。
                注意，这实际上更接近于 PATCH 操作：只有提供的字段将被更新，而省略的字段将保持为以前的值。                
            operationId: filterV2Put
            parameters:
                - description: 过滤规则的 ID.
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    过滤规则的标题。

                    示例: 挂人                    
                  in: formData
                  maxLength: 200
                  minLength: 1
                  name: title
                  required: true
                  type: string
                - collectionFormat: multi
                  description: 要添加到此过滤规则的关键词。
                  in: formData
                  items:
                    type: string
                  name: keywords_attributes[][keyword]
                  type: array
                - collectionFormat: multi
                  description: 匹配关键词时是否考虑单词边界 (整词匹配)？
                  in: formData
                  items:
                    type: boolean
                  name: keywords_attributes[][whole_word]
                  type: array
                - collectionFormat: multi
                  description: 要添加到过滤规则的贴文。
                  in: formData
                  items:
                    type: string
                  name: statuses_attributes[][status_id]
                  type: array
                - collectionFormat: multi
                  description: |-
                    此过滤规则要应用的上下文。

                    示例: home, public                    
                  in: formData
                  items:
                    enum:
                      - home
                      - notifications
                      - public
                      - thread
                      - account
                    type: string
                  minItems: 1
                  name: context[]
                  required: true
                  type: array
                  uniqueItems: true
                - description: |-
                    此过滤规则的持续时间（以秒为单位）。若省略，则过滤规则永不过期。

                    示例: 86400                    
                  in: formData
                  name: expires_in
                  type: number
                - description: |-
                    贴文命中过滤规则时的操作。

                    示例: warn                    
                  enum:
                    - warn
                    - hide
                  in: formData
                  name: filter_action
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的过滤规则。
                    schema:
                        $ref: '#/definitions/filterV2'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突（重复的标题、关键词或贴文）
                "422":
                    description: unprocessable 无法处理的内容
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 更新V2过滤规则
            tags:
                - filters
    /api/v2/filters/{id}/keywords:
        get:
            operationId: filterKeywordsGet
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则关键词
                    schema:
                        items:
                            $ref: '#/definitions/filterKeyword'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取过滤规则关键词
            description: 获取给定 ID 的过滤规则的所有关键词。
            tags:
                - filters
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterKeywordPost
            parameters:
                - description: 要将贴文添加到的过滤规则的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    要被过滤的文本

                    示例：挂人                    
                  in: formData
                  maxLength: 40
                  minLength: 1
                  name: keyword
                  required: true
                  type: string
                - default: false
                  description: |-
                    此过滤规则是否应考虑单词边界（整词匹配）？

                    示例：true                    
                  in: formData
                  name: whole_word
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 新的过滤规则关键词。
                    schema:
                        $ref: '#/definitions/filterKeyword'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突（重复的关键词）
                "422":
                    description: unprocessable 无法处理的内容
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 添加关键词
            description: 向给定 ID 的过滤规则添加关键词。
            tags:
                - filters
    /api/v2/filters/{id}/statuses:
        get:
            operationId: filterStatusesGet
            parameters:
                - description: 过滤规则的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则贴文。
                    schema:
                        items:
                            $ref: '#/definitions/filterStatus'
                        type: array
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取过滤规则贴文
            description: 获取给定过滤规则下的所有贴文。
            tags:
                - filters
        post:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterStatusPost
            parameters:
                - description: 要将贴文添加到的过滤规则的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    要过滤的贴文的 ID。

                    示例：01HXA2NE0K8T1C70K90E74GYD0                    
                  in: formData
                  name: status_id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 新的过滤规则贴文。
                    schema:
                        $ref: '#/definitions/filterStatus'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突（重复的贴文）
                "422":
                    description: unprocessable 无法处理的内容
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 添加贴文
            description: 向已有过滤规则添加一条贴文。
            tags:
                - filters
    /api/v2/filters/keywords/{id}:
        delete:
            operationId: filterKeywordDelete
            parameters:
                - description: 过滤规则关键词的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 过滤规则关键词已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 删除过滤规则关键词
            description: 通过指定 ID 删除某个过滤规则关键词。
            tags:
                - filters
        get:
            operationId: filterKeywordGet
            parameters:
                - description: 过滤规则关键词的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则关键词。
                    schema:
                        $ref: '#/definitions/filterKeyword'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取过滤规则关键词
            description: 获取具有给定 ID 的单个过滤规则关键词。
            tags:
                - filters
    /api/v2/filters/keywords{id}:
        put:
            consumes:
                - application/json
                - application/xml
                - application/x-www-form-urlencoded
            operationId: filterKeywordPut
            parameters:
                - description: 要更新的过滤规则关键词的 ID。
                  in: path
                  name: id
                  required: true
                  type: string
                - description: |-
                    要过滤的文本

                    示例：挂人                    
                  in: formData
                  maxLength: 40
                  minLength: 1
                  name: keyword
                  required: true
                  type: string
                - description: |-
                    过滤时是否考虑单词边界（整词匹配）？

                    示例：true                    
                  in: formData
                  name: whole_word
                  type: boolean
            produces:
                - application/json
            responses:
                "200":
                    description: 更新后的过滤关键词。
                    schema:
                        $ref: '#/definitions/filterKeyword'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: 禁止对已迁移的账户执行此操作
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "409":
                    description: conflict 冲突（重复的关键词）
                "422":
                    description: unprocessable 无法处理 content
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 更新过滤规则关键词
            description: 更新具有给定 ID 的单个过滤规则关键词。
            tags:
                - filters
    /api/v2/filters/statuses/{id}:
        delete:
            operationId: filterStatusDelete
            parameters:
                - description: 过滤规则贴文的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 过滤规则贴文已删除
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - write:filters
            summary: 删除过滤规则贴文
            description: 删除具有给定 ID 的单个过滤规则贴文。
            tags:
                - filters
        get:
            operationId: filterStatusGet
            parameters:
                - description: 过滤规则贴文的 ID
                  in: path
                  name: id
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: 请求的过滤规则贴文。
                    schema:
                        $ref: '#/definitions/filterStatus'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "404":
                    description: not found 未找到
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            security:
                - OAuth2 Bearer:
                    - read:filters
            summary: 获取过滤规则贴文
            description: 获取具有给定 ID 的单个过滤规则贴文。
            tags:
                - filters
    /api/v2/instance:
        get:
            operationId: instanceGetV2
            produces:
                - application/json
            responses:
                "200":
                    description: 实例信息。
                    schema:
                        $ref: '#/definitions/instanceV2'
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal error
            summary: 查看实例信息
            tags:
                - instance
    /livez:
        get:
            operationId: liveGet
            responses:
                "200":
                    description: OK
            summary: 服务在线检测
            description: 若 GoToSocial 服务“在线” (即能够响应HTTP请求)，则返回无响应体的 200 状态码。
            tags:
                - health
        head:
            operationId: liveHead
            responses:
                "200":
                    description: OK
            summary: 服务在线检测
            description: 若 GoToSocial 服务“在线” (即能够响应HTTP请求)，则返回 200 状态码。
            tags:
                - health
    /nodeinfo/{schema_version}:
        get:
            description: '对 nodeinfo 查询返回符合规范的 nodeinfo 响应。参见: https://nodeinfo.diaspora.software/schema.html'
            operationId: nodeInfoGet
            parameters:
                - description: 请求的 nodeinfo 规范版本。目前支持 2.0 和 2.1。
                  in: path
                  name: schema_version
                  required: true
                  type: string
            produces:
                - application/json; profile="http://nodeinfo.diaspora.software/ns/schema/2.0#"
                - application/json; profile="http://nodeinfo.diaspora.software/ns/schema/2.1#"
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/nodeinfo'
            summary: NodeInfo 2.0
            tags:
                - nodeinfo
    /oauth/revoke:
        post:
            consumes:
                - multipart/form-data
            operationId: oauthTokenRevoke
            parameters:
                - description: 客户端 ID，在注册应用时获取。
                  in: formData
                  name: client_id
                  required: true
                  type: string
                - description: 客户端密钥，在注册应用时获取。
                  in: formData
                  name: client_secret
                  required: true
                  type: string
                - description: 已获取的令牌，令牌将作废。
                  in: formData
                  name: token
                  required: true
                  type: string
            produces:
                - application/json
            responses:
                "200":
                    description: OK - 如果你拥有你所提供的令牌，API 调用将返回 OK 和一个空响应 `{}`。此操作是幂等的，因此多次调用此 API 将仍然返回 OK。
                "400":
                    description: bad request 无效请求
                "403":
                    description: forbidden - 如果你提供了一个你并不拥有的令牌，API 调用将返回 403 错误。
                "406":
                    description: not acceptable 不可接受
                "500":
                    description: internal server error 服务器内部错误
            summary: 撤销访问令牌
            description: 撤销访问令牌，使其不再可用。
            tags:
                - oauth
    /readyz:
        get:
            description: 若 GoToSocial 服务“就绪” (即能够连接到数据库后端并执行简单的 SELECT)，则返回无响应体的 200 状态码。若 GtS 尚未准备就绪，则在日志中记录错误（但不返回给调用方，以避免泄露内部信息）。
            operationId: readyGet
            responses:
                "200":
                    description: OK
                "500":
                    description: 尚未就绪。查看日志以获取错误信息。
            summary: 服务就绪检测
            tags:
                - health
        head:
            description: 若 GoToSocial 服务“就绪” (即能够连接到数据库后端并执行简单的 SELECT)，则返回无响应体的 200 状态码。若 GtS 尚未准备就绪，则在日志中记录错误（但不返回给调用方，以避免泄露内部信息）。
            operationId: readyHead
            responses:
                "200":
                    description: OK
            summary: 服务就绪检测
            tags:
                - health
    /users/{username}/collections/featured:
        get:
            description: |-
                获取某个用户的精选集合（置顶贴文）。
                响应将包含 `items` 属性中的 Note URI 的有序集合。

                由调用方决定是否解析提供的 Note URIs（如果它们已经缓存，则不解析）。

                请求需要 HTTP 签名。                
            operationId: s2sFeaturedCollectionGet
            parameters:
                - description: 用户的账户名
                  in: path
                  name: username
                  required: true
                  type: string
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerFeaturedCollection'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
            summary: 获取用户精选集合
            tags:
                - s2s/federation
    /users/{username}/outbox:
        get:
            description: |-
                获取用户的公开发件箱集合。

                注意，如果 `page` 为 `false`，则响应将是一个带有 `first` 页的 Collection，如下所示。

                如果 `page` 为 `true`，则响应将是一个不带 `Collection` 包装的单个 `CollectionPage`。

                请求需要 HTTP 签名。                
            operationId: s2sOutboxGet
            parameters:
                - description: 账户的用户名。
                  in: path
                  name: username
                  required: true
                  type: string
                - default: false
                  description: 按 CollectionPage 返回响应。
                  in: query
                  name: page
                  type: boolean
                - description: 下一贴文的最小 ID，用于分页。
                  in: query
                  name: min_id
                  type: string
                - description: 下一贴文的最大 ID，用于分页。
                  in: query
                  name: max_id
                  type: string
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerCollection'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
            summary: 获取用户发件箱
            tags:
                - s2s/federation
    /users/{username}/statuses/{status}/replies:
        get:
            description: |-
                获取贴文的回复集合。

                注意，如果 `page` 为 `false`，则响应将是一个带有 `first` 页的 Collection，如下所示。

                如果 `page` 为 `true`，则响应将是一个不带 `Collection` 包装的单个 `CollectionPage`。

                请求需要 HTTP 签名。                
            operationId: s2sRepliesGet
            parameters:
                - description: 账户的用户名。
                  in: path
                  name: username
                  required: true
                  type: string
                - description: 贴文的 ID。
                  in: path
                  name: status
                  required: true
                  type: string
                - default: false
                  description: 按 CollectionPage 返回响应。
                  in: query
                  name: page
                  type: boolean
                - default: false
                  description: 返回仅来自贴文所有者以外的账户的回复。
                  in: query
                  name: only_other_accounts
                  type: boolean
                - description: 下一贴文的最小 ID，用于分页。
                  in: query
                  name: min_id
                  type: string
            produces:
                - application/activity+json
            responses:
                "200":
                    description: ""
                    schema:
                        $ref: '#/definitions/swaggerCollection'
                "400":
                    description: bad request 无效请求
                "401":
                    description: unauthorized 未授权
                "403":
                    description: forbidden 禁止
                "404":
                    description: not found 未找到
            summary: 获取贴文回复
            tags:
                - s2s/federation
schemes:
    - https
    - http
securityDefinitions:
    OAuth2 Application:
        flow: application
        scopes:
            write:accounts: grants write access to accounts 授予对账户的写入权限
        tokenUrl: https://example.org/oauth/token
        type: oauth2
    OAuth2 Bearer:
        authorizationUrl: https://example.org/oauth/authorize
        flow: accessCode
        scopes:
            admin: 授予对所有内容的管理权限
            admin:read: 授予对所有内容的读取权限
            admin:read:accounts: 授予对账户的读取权限
            admin:read:domain_allows: 授予对域名白名单的读取权限
            admin:read:domain_blocks: 授予对域名黑名单的读取权限
            admin:read:reports: 授予对举报的读取权限
            admin:write: 授予对所有内容的写入权限
            admin:write:accounts: 授予对账户的写入权限
            admin:write:domain_allows: 授予对域名白名单的写入权限
            admin:write:domain_blocks: 授予对域名黑名单的写入权限
            admin:write:reports: 授予对举报的写入权限
            profile: 授予对凭据验证端点的读取权限
            push: 授予对推送的读取和写入权限
            read: 授予对所有内容的读取权限
            read:accounts: 授予对账户的读取权限
            read:applications: 授予对用户管理的应用的读取权限
            read:blocks: 授予对屏蔽状态的读取权限
            read:bookmarks: 授予对收藏的读取权限
            read:favourites: 授予对点赞的读取权限
            read:filters: 授予对过滤规则的读取权限
            read:follows: 授予对关注的读取权限
            read:lists: 授予对列表的读取权限
            read:mutes: 授予对隐藏状态的读取权限
            read:notifications: 授予对通知的读取权限
            read:search: 授予对搜索的读取权限
            read:statuses: 授予对贴文的读取权限
            write: 授予对所有内容的写入权限
            write:accounts: 授予对账户的写入权限
            write:applications: 授予对用户管理的应用的写入权限
            write:blocks: 授予对屏蔽状态的写入权限
            write:bookmarks: 授予对收藏的写入权限
            write:conversations: 授予对对话的写入权限
            write:favourites: 授予对点赞的写入权限
            write:filters: 授予对过滤规则的写入权限
            write:follows: 授予对关注的写入权限
            write:lists: 授予对列表的写入权限
            write:media: 授予对媒体的写入权限
            write:mutes: 授予对隐藏状态的写入权限
            write:notifications: 授予对通知的写入权限
            write:reports: 授予对举报的写入权限
            write:statuses: 授予对贴文的写入权限
        tokenUrl: https://example.org/oauth/token
        type: oauth2
swagger: "2.0"