Пояснения к полям тем с ограниченным временем в API

Разработка
1

Для моего проекта я хотел бы программно создавать запланированные темы. Я думал использовать конечную точку API таймера тем, но немного запутался в некоторых полях.

  • Параметр пути id — просто ID темы, которую нужно запланировать.
  • time — в каком формате должно быть указано время? В документации сказано только «string».
  • status_type — не уверен, какие у него допустимые значения. Я думал, они будут похожи на перечисление status в API обновления статуса, но в примере для таймера указано «publish_to_category», чего нет в перечислении.
  • based_on_last_post — не понимаю, что означает этот булевый флаг.
  • category_id — просто ID категории.
2

app/models/topic_timer.rb:

close
open
publish_to_category
delete
reminder
bump
delete_replies

Нашёл комментарий в коде:

  • Целое число, обозначающее количество часов от текущего момента до обновления статуса темы.
  • Временная метка, например “2013-11-25 13:00”, когда должно обновиться состояние темы.
  • Временная метка с часовым поясом в формате JSON (например, “2013-11-26T21:00:00.000Z”).
  • based_on_last_post: True, если время должно определяться на основе временной метки последнего сообщения.
3

Спасибо, ссылка на комментарии: discourse/app/models/topic.rb at 0863c36221130b161d63562a58ac97171475dca5 · discourse/discourse · GitHub

Метод set_or_create_timer в models/topic.rb содержит логику, поддерживающую этот API