Mastodon
  • 什么是 Mastodon?
  • 使用 Mastodon
    • 注册帐户
    • 设置你的个人资料
    • 在你的账户发布内容
    • 使用网络功能
    • 处理不想看到的内容
    • 推广你和他人
    • 进行偏好设置
    • 更多设置
    • 在站点外使用 Mastodon
    • 迁移或离开账户
    • 运行你自己的站点
  • 运营 Mastodon
    • 准备你的服务器
    • 从源代码安装
    • 配置你的环境
    • 安装可选功能
      • 对象存储
      • 洋葱服务
      • 验证码
      • 单点登录
    • 配置全文搜索
    • 设置你的新实例
    • 使用管理 CLI
    • 升级到新版本
    • 备份你的服务器
    • 迁移到新机器
    • 扩大你的站点规模
    • 审核操作
    • 故障排除
      • 数据库索引损坏
    • 用户组
  • 开发 Mastodon 应用
    • API 入门指南
    • 使用公开数据
    • 获取客户端应用访问权限
    • 使用帐户登录
    • 库与实现
  • 向 Mastodon 项目做贡献
    • 技术概览
    • 设置开发环境
    • 代码结构
    • 路由
    • 漏洞赏金与责任披露
  • 遵循的标准
    • ActivityPub
    • WebFinger
    • 安全性
    • Microformats
    • OAuth
    • Bearcaps
  • REST API
    • Datetime 格式
    • 指南与最佳实践
    • OAuth 令牌
    • OAuth 作用域
    • 速率限制
  • API 方法
    • apps
      • oauth
      • emails
    • accounts
      • bookmarks
      • favourites
      • mutes
      • blocks
      • domain_blocks
      • filters
      • reports
      • follow_requests
      • endorsements
      • featured_tags
      • preferences
      • followed_tags
      • suggestions
      • tags
    • profile
    • statuses
      • media
      • polls
      • scheduled_statuses
    • timelines
      • conversations
      • lists
      • markers
      • streaming
    • grouped notifications
    • notifications
      • push
    • search
    • instance
      • trends
      • directory
      • custom_emojis
      • announcements
    • admin
      • accounts
      • canonical_email_blocks
      • dimensions
      • domain_allows
      • domain_blocks
      • email_domain_blocks
      • ip_blocks
      • measures
      • reports
      • retention
      • trends
    • proofs
    • oembed
  • API 实体
    • Account
    • AccountWarning
    • Admin::Account
    • Admin::CanonicalEmailBlock
    • Admin::Cohort
    • Admin::Dimension
    • Admin::DomainAllow
    • Admin::DomainBlock
    • Admin::EmailDomainBlock
    • Admin::Ip
    • Admin::IpBlock
    • Admin::Measure
    • Admin::Report
    • Announcement
    • Appeal
    • Application
    • Context
    • Conversation
    • CustomEmoji
    • DomainBlock
    • Error
    • ExtendedDescription
    • FamiliarFollowers
    • FeaturedTag
    • Filter
    • FilterKeyword
    • FilterResult
    • FilterStatus
    • IdentityProof
    • Instance
    • List
    • Marker
    • MediaAttachment
    • Notification
    • NotificationPolicy
    • NotificationRequest
    • Poll
    • Preferences
    • PreviewCard
    • PreviewCardAuthor
    • PrivacyPolicy
    • Reaction
    • Relationship
    • RelationshipSeveranceEvent
    • Report
    • Role
    • Rule
    • ScheduledStatus
    • Search
    • Status
    • StatusEdit
    • StatusSource
    • Suggestion
    • Tag
    • TermsOfService
    • Token
    • Translation
    • V1::Filter
    • V1::Instance
    • V1::NotificationPolicy
    • WebPushSubscription

V1::Instance

表示在此域名上运行的 Mastodon 软件实例。

    • 示例
    • 属性
      • uri
      • title
      • short_description
      • description
      • email
      • version
      • urls
      • stats
      • thumbnail
      • languages
      • registrations
      • approval_required
      • invites_enabled
      • configuration
      • contact_account
      • rules
    • 参见

示例

{
  "uri":"mastodon.social",
  "title":"Mastodon",
  "short_description":"The original server operated by the Mastodon gGmbH non-profit",
  "description":"",
  "email":"staff@mastodon.social",
  "version":"3.5.3",
  "urls":{
    "streaming_api":"wss://mastodon.social"
  },
  "stats":{
    "user_count":812303,
    "status_count":38151616,
    "domain_count":25255
  },
  "thumbnail":"https://files.mastodon.social/site_uploads/files/000/000/001/original/vlcsnap-2018-08-27-16h43m11s127.png",
  "languages":[
    "en"
  ],
  "registrations":false,
  "approval_required":false,
  "invites_enabled":true,
  "configuration":{
    "statuses":{
      "max_characters":500,
      "max_media_attachments":4,
      "characters_reserved_per_url":23
    },
    "media_attachments":{
      "supported_mime_types":[
        "image/jpeg",
        "image/png",
        "image/gif",
        "image/webp",
        "video/webm",
        "video/mp4",
        "video/quicktime",
        "video/ogg",
        "audio/wave",
        "audio/wav",
        "audio/x-wav",
        "audio/x-pn-wave",
        "audio/vnd.wave",
        "audio/ogg",
        "audio/vorbis",
        "audio/mpeg",
        "audio/mp3",
        "audio/webm",
        "audio/flac",
        "audio/aac",
        "audio/m4a",
        "audio/x-m4a",
        "audio/mp4",
        "audio/3gpp",
        "video/x-ms-asf"
      ],
      "image_size_limit":10485760,
      "image_matrix_limit":16777216,
      "video_size_limit":41943040,
      "video_frame_rate_limit":60,
      "video_matrix_limit":2304000
    },
    "polls":{
      "max_options":4,
      "max_characters_per_option":50,
      "min_expiration":300,
      "max_expiration":2629746
    }
  },
  "contact_account":{
    "id":"1",
    "username":"Gargron",
    "acct":"Gargron",
    "display_name":"Eugen",
    "locked":false,
    "bot":false,
    "discoverable":true,
    "group":false,
    "created_at":"2016-03-16T00:00:00.000Z",
    "note":"\u003cp\u003eFounder, CEO and lead developer \u003cspan class=\"h-card\"\u003e\u003ca href=\"https://mastodon.social/@Mastodon\" class=\"u-url mention\"\u003e@\u003cspan\u003eMastodon\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e, Germany.\u003c/p\u003e",
    "url":"https://mastodon.social/@Gargron",
    "avatar":"https://files.mastodon.social/accounts/avatars/000/000/001/original/dc4286ceb8fab734.jpg",
    "avatar_static":"https://files.mastodon.social/accounts/avatars/000/000/001/original/dc4286ceb8fab734.jpg",
    "header":"https://files.mastodon.social/accounts/headers/000/000/001/original/3b91c9965d00888b.jpeg",
    "header_static":"https://files.mastodon.social/accounts/headers/000/000/001/original/3b91c9965d00888b.jpeg",
    "followers_count":118944,
    "following_count":305,
    "statuses_count":72309,
    "last_status_at":"2022-08-24",
    "emojis":[
      
    ],
    "fields":[
      {
        "name":"Patreon",
        "value":"\u003ca href=\"https://www.patreon.com/mastodon\" target=\"_blank\" rel=\"nofollow noopener noreferrer me\"\u003e\u003cspan class=\"invisible\"\u003ehttps://www.\u003c/span\u003e\u003cspan class=\"\"\u003epatreon.com/mastodon\u003c/span\u003e\u003cspan class=\"invisible\"\u003e\u003c/span\u003e\u003c/a\u003e",
        "verified_at":null
      }
    ]
  },
  "rules":[
    {
      "id":"1",
      "text":"Sexually explicit or violent media must be marked as sensitive when posting"
    },
    {
      "id":"2",
      "text":"No racism, sexism, homophobia, transphobia, xenophobia, or casteism"
    },
    {
      "id":"3",
      "text":"No incitement of violence or promotion of violent ideologies"
    },
    {
      "id":"4",
      "text":"No harassment, dogpiling or doxxing of other users"
    },
    {
      "id":"5",
      "text":"No content illegal in Germany"
    },
    {
      "id":"7",
      "text":"Do not share intentionally false or misleading information"
    }
  ]
}

属性

uri

描述: 实例的域名。
类型: 字符串
版本历史:
1.1.0 - 添加

title

描述: 网站的标题。
类型: 字符串
版本历史:
1.1.0 - 添加

short_description

描述: 由管理员定义的简短纯文本描述。
类型: 字符串
版本历史:
2.9.2 - 添加

description

描述: 允许使用 HTML 的 Mastodon 站点描述。
类型: 字符串
版本历史:
1.1.0 - 添加

email

描述: 可供任何咨询联系的电子邮件地址。
类型: 字符串
版本历史:
1.1.0 - 添加

version

描述: 实例上安装的 Mastodon 版本。
类型: 字符串
版本历史:
1.3.0 - 添加

urls

描述: 客户端应用感兴趣的 URL。
类型: Hash
版本历史:
1.4.2 - 添加

urls[streaming_api]

描述: 用于连接到流式 API 的 Websockets URL。
类型: 字符串 (URL)
版本历史:
1.4.2 - 添加

stats

描述: 关于实例包含多少信息的统计数据。
类型: Hash
版本历史:
1.6.0 - 添加

stats[user_count]

描述: 此实例上的用户总数。
类型: 整数
版本历史:
1.6.0 - 添加

stats[status_count]

描述: 此实例上的嘟文总数。
类型: 整数
版本历史:
1.6.0 - 添加

stats[domain_count]

描述: 此实例发现的域名总数。
类型: 整数
版本历史:
1.6.0 - 添加

thumbnail

描述: 网站的横幅图片。
类型: nullable 字符串 (URL)
版本历史:
1.6.1 - 添加

languages

描述: 网站及其工作人员的主要语言。
类型: Array of String (ISO 639-1 双字母代码)
版本历史:
2.3.0 - 添加

registrations

描述: 是否允许注册。
类型: 布尔值
版本历史:
2.7.2 - 添加

approval_required

描述: 注册是否需要管理员批准。
类型: 布尔值
版本历史:
2.9.2 - 添加

invites_enabled

描述: 是否启用了邀请。
类型: 布尔值
版本历史:
3.1.4 - 添加

configuration

描述: 此网站的配置值和限制。
类型: Hash
版本历史:
3.4.2 - 添加

configuration[accounts]

描述: 与帐户相关的限制。
类型: Hash
版本历史:
4.0.0 - 添加

configuration[accounts][max_featured_tags]

描述: 每个帐户允许的最大特色话题标签数。
类型: 整数
版本历史:
4.0.0 - 添加

configuration[statuses]

描述: 与发布嘟文相关的限制。
类型: Hash
版本历史:
3.4.2 - 添加

configuration[statuses][max_characters]

描述: 每条嘟文允许的最大字符数。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[statuses][max_media_attachments]

描述: 可以添加到嘟文的媒体附件的最大数量。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[statuses][characters_reserved_per_url]

描述: 嘟文中的每个 URL 将被假定占据的字符数。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[media_attachments]

描述: 有关可接受的媒体附件格式范围的提示。
类型: Hash
版本历史:
3.4.2 - 添加

configuration[media_attachments][supported_mime_types]

描述: 包含可以上传的 MIME 类型。
类型: 字符串数组
版本历史:
3.4.2 - 添加

configuration[media_attachments][image_size_limit]

描述: 所有上传图像的最大大小(以字节为单位)。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[media_attachments][image_matrix_limit]

描述: 图像上传的最大像素数(宽度乘以高度)。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[media_attachments][video_size_limit]

描述: 所有上传视频的最大大小(以字节为单位)。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[media_attachments][video_frame_rate_limit]

描述: 所有上传视频的最大帧速率。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[media_attachments][video_matrix_limit]

描述: 视频上传的最大像素数(宽度乘以高度)。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[polls]

描述: 与投票相关的限制。
类型: Hash
版本历史:
3.4.2 - 添加

configuration[polls][max_options]

描述: 每次投票最多允许的选项数。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[polls][max_characters_per_option]

描述: 每个投票选项允许包含的字符数。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[polls][min_expiration]

描述: 允许的最短投票持续时间(以秒为单位)。
类型: 整数
版本历史:
3.4.2 - 添加

configuration[polls][max_expiration]

描述: 允许的最长投票持续时间(以秒为单位)。
类型: 整数
版本历史:
3.4.2 - 添加

contact_account

描述: 可供联系的用户,作为 email 的替代方案。
类型: nullable Account or null
版本历史:
2.3.0 - 添加

rules

描述: 此网站的规则的详细列表。
类型: Rule 的数组
版本历史:
3.4.0 - 添加

参见

GET /api/v1/instance
app/serializers/rest/v1/instance_serializer.rb

翻译状态: 本文是英文页面 V1::Instance 的翻译,最后翻译时间:2025-04-21,点击这里可以查看翻译后页面的改动。

最后更新于 April 21, 2025 · 改进此页面
也可在此找到: English

赞助商

Dotcom-Monitor LoadView Stephen Tures Swayable SponsorMotion

加入Mastodon · 博客 ·

查看源代码 · CC BY-SA 4.0 · 版权信息