docs-mastodon/content/zh-cn/entities/ScheduledStatus.md

title	description	menu	aliases
ScheduledStatus	表示一条计划在未来日期发布的嘟文。	docs parent entities	/entities/scheduledstatus /entities/ScheduledStatus /api/entities/scheduledstatus /api/entities/ScheduledStatus

示例

POST /api/v1/statuses?status=test post&scheduled_at=2022-09-29 返回：

{
  "id": "1",
  "scheduled_at": "2022-09-29T00:00:00.000Z",
  "params": {
    "text": "test post",
    "media_ids": null,
    "sensitive": null,
    "spoiler_text": null,
    "visibility": null,
    "language": null,
    "scheduled_at": null,
    "poll": null,
    "idempotency": null,
    "with_rate_limit": false,
    "in_reply_to_id": null,
    "application_id": 3
  },
  "media_attachments": []
}

GET /api/v1/scheduled_statuses 返回：

{
  "id": "1",
  "scheduled_at": "2022-09-29T00:00:00.000Z",
  "params": {
    "poll": null,
    "text": "test post",
    "language": null,
    "media_ids": null,
    "sensitive": null,
    "visibility": null,
    "idempotency": null,
    "scheduled_at": null,
    "spoiler_text": null,
    "application_id": 3,
    "in_reply_to_id": null,
    "with_rate_limit": false
  },
  "media_attachments": []
}

属性

id

描述: 数据库中定时嘟文的 ID。
类型: 字符串 (由整数转换而来，但不保证为数字)
版本历史:
2.7.0 - 添加

scheduled_at

描述: 嘟文计划被发布的 Unix 时间戳。
类型: (Datetime) 字符串
版本历史:
2.7.0 - 添加

params

描述: 调度嘟文时使用的参数，将在发布嘟文时使用。
类型: 哈希
版本历史:
2.7.0 - 添加

params[text]

描述: 将用作嘟文内容的文本。
类型: 字符串
版本历史:
2.7.0 - 添加

params[poll]

描述: 要附加到嘟文的投票。
类型: {{}} 哈希
版本历史:
2.8.0 - 添加

params[poll][options[]]

描述: 要使用的投票选项。
类型: 字符串数组
版本历史:
2.8.0 - 添加

params[poll][expires_in]

描述: 投票在关闭前应持续多少秒。
类型: 字符串（从整数转换）
版本历史:
2.8.0 - 添加

params[poll][multiple]

描述: 投票是否允许多选。
类型: {{}} 布尔值
版本历史:
2.8.0 - 添加

params[poll][hide_totals]

描述: 投票是否应隐藏总票数，直到投票结束后再显示。
类型: {{}} 布尔值
版本历史:
2.8.0 - 添加

params[media_ids]

描述: 将附加到嘟文的 MediaAttachment 的 ID。
类型: {{}} 字符串数组
版本历史:
2.7.0 - 添加

params[sensitive]

描述: 嘟文是否将被标记为敏感。
类型: {{}} 布尔值
版本历史:
2.7.0 - 添加

params[spoiler_text]

描述: 嘟文的内容警告或摘要的文本。
类型: {{}} 字符串
版本历史:
2.7.0 - 添加

params[visibility]

描述: 嘟文发布后将具有的可见性。
类型: 字符串 (可枚举 oneOf)
public = 对所有人可见，显示在公共时间线中。
unlisted = 对公众可见，但不包含在公共时间线中。
private = 仅对关注者和任何被提及的用户可见。
direct = 仅对被提及的用户可见。
版本历史:
2.7.0 - 添加

params[in_reply_to_id]

描述: 将回复的嘟文的 ID。
类型: {{}} 整数
版本历史:
2.7.0 - 添加

params[language]

描述: 将用于嘟文的语言。
类型: {{}} 字符串 (ISO 639-1 双字母语言代码)
版本历史:
2.7.0 - 添加

params[application_id] {{%deprecated%}}

描述: 发布嘟文的应用的内部 ID。 仅为保留后向兼容性提供，可以忽略。
类型: 整数
版本历史:
2.7.0 - 添加

params[scheduled_at]

描述: 嘟文的定时发布时间。 这将为 null，因为嘟文只被计划一次。
类型: {{}} Null
版本历史:
2.7.0 - 添加

params[idempotency]

描述: 幂等性键，用于防止重复发布嘟文。
类型: {{}} 字符串
版本历史:
2.7.0 - 添加

params[with_rate_limit] {{%deprecated%}}

描述: 嘟文创建是否受速率限制。 仅为保留后向兼容性提供，可以忽略。
类型: 布尔值
版本历史:
2.7.0 - 添加

media_attachments

描述: 发布嘟文时将附加的媒体。
类型: [MediaAttachment]({{< relref "entities/MediaAttachment" >}}) 数组
版本历史:
2.7.0 - 添加

参见

{{< page-relref ref="methods/statuses#create" caption="POST /api/v1/statuses (带有 scheduled_at 参数)" >}}

{{< page-relref ref="methods/scheduled_statuses" caption="scheduled_statuses API 方法" >}}

{{< caption-link url="https://github.com/mastodon/mastodon/blob/main/app/serializers/rest/scheduled_status_serializer.rb" caption="app/serializers/rest/scheduled_status_serializer.rb" >}}

{{< translation-status-zh-cn raw_title="ScheduledStatus" raw_link="/entities/ScheduledStatus/" last_translation_time="2025-04-21" raw_commit="6addd5cf525adec1859f48c52dafcfe1f96e558a">}}