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

Announcement

表示管理员设置的公告。

    • 示例
    • 属性
      • id
      • content
      • starts_at
      • ends_at
      • published
      • all_day
      • published_at
      • updated_at
      • read 可选
      • mentions
      • statuses
      • tags
      • emojis
      • reactions
    • Announcement::Account attributes
      • id
      • username
      • url
      • acct
    • Announcement::Status attributes
      • id
      • url
    • 参见

示例

{
  "id": "8",
  "content": "<p>Looks like there was an issue processing audio attachments without embedded art since yesterday due to an experimental new feature. That issue has now been fixed, so you may see older posts with audio from other servers pop up in your feeds now as they are being finally properly processed. Sorry!</p>",
  "starts_at": null,
  "ends_at": null,
  "all_day": false,
  "published_at": "2020-07-03T01:27:38.726Z",
  "updated_at": "2020-07-03T01:27:38.752Z",
  "read": true,
  "mentions": [],
  "statuses": [],
  "tags": [],
  "emojis": [],
  "reactions": [
    {
      "name": "bongoCat",
      "count": 9,
      "me": false,
      "url": "https://files.mastodon.social/custom_emojis/images/000/067/715/original/fdba57dff7576d53.png",
      "static_url": "https://files.mastodon.social/custom_emojis/images/000/067/715/static/fdba57dff7576d53.png"
    },
    {
      "name": "thonking",
      "count": 1,
      "me": false,
      "url": "https://files.mastodon.social/custom_emojis/images/000/098/690/original/a8d36edc4a7032e8.png",
      "static_url": "https://files.mastodon.social/custom_emojis/images/000/098/690/static/a8d36edc4a7032e8.png"
    },
    {
      "name": "AAAAAA",
      "count": 1,
      "me": false,
      "url": "https://files.mastodon.social/custom_emojis/images/000/071/387/original/AAAAAA.png",
      "static_url": "https://files.mastodon.social/custom_emojis/images/000/071/387/static/AAAAAA.png"
    },
    {
      "name": "🤔",
      "count": 1,
      "me": true
    }
  ]
}

属性

id

描述: 数据库中公告的 ID。
类型: 字符串(从整数转换而来,但不保证一定是数字)
版本历史:
3.1.0 - 添加

content

描述: 公告的文本内容。
类型: 字符串 (HTML)
版本历史:
3.1.0 - 添加

starts_at

描述: 公告开始的时间。
类型: nullable 字符串 (Datetime) 或 null
版本历史:
3.1.0 - 添加

ends_at

描述: 公告结束的时间。
类型: nullable 字符串 (Datetime) 或 null
版本历史:
3.1.0 - 添加

published

描述: 公告当前是否处于发布状态。
类型: 布尔值
版本历史:
3.1.0 - 添加

all_day

描述: 公告是否应仅在日期上开始和结束,而不是在特定的时间点开始和结束。如果没有 starts_at 或 ends_at 时间,则为 false。
类型: 布尔值
版本历史:
3.1.0 - 添加

published_at

描述: 公告发布的时间。
类型: (Datetime) 字符串
版本历史:
3.1.0 - 添加

updated_at

描述: 公告上次更新的时间。
类型: (Datetime) 字符串
版本历史:
3.1.0 - 添加

read 可选

描述: 当前已读该公告的用户。
类型: 布尔值
版本历史:
3.1.0 - 添加

mentions

描述: 公告文本中提及的帐户。
类型: Array of Announcement::Account
版本历史:
3.1.0 - 添加

statuses

描述: 公告文本中链接的嘟文。
类型: Array of Announcement::Status
版本历史:
3.1.0 - 添加

tags

描述: 公告文本中链接的话题标签。
类型: Array of Status::Tag
版本历史:
3.1.0 - 添加

emojis

描述: 公告文本中使用的自定义表情。
类型: Array of CustomEmoji
版本历史:
3.1.0 - 添加

reactions

描述: 附加到公告的表情回应。
类型: Array of Reaction
版本历史:
3.1.0 - 添加

Announcement::Account attributes

id

描述: 被提及用户的帐户 ID。
类型: 字符串(从整数转换而来,但不保证一定是数字)
版本历史:
3.1.0 - 添加

username

描述: 被提及用户的用户名。
类型: 字符串
版本历史:
3.1.0 - 添加

url

描述: 被提及用户的账户位置。
类型: 字符串 (URL)
版本历史:
3.1.0 - 添加

acct

描述: 被提及用户的 webfinger acct: URI。对于本站用户,等同于 username;对于外站用户,等同于 username@domain。
类型: 字符串
版本历史:
3.1.0 - 添加

Announcement::Status attributes

id

描述: 数据库中附加嘟文的 ID。
类型: 字符串(从整数转换而来,但不保证一定是数字)
版本历史:
3.1.0 - 添加

url

描述: 附加嘟文的 URL。
类型: 字符串 (URL)
版本历史:
3.1.0 - 添加

参见

公告 API 方法
app/serializers/rest/announcement_serializer.rb

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

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

赞助商

Dotcom-Monitor LoadView Stephen Tures Swayable SponsorMotion

加入Mastodon · 博客 ·

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