API에서 시간 지정된 주제 필드 설명

개발
1

제 프로젝트에서 예약된 주제를 프로그래밍 방식으로 생성하려고 합니다. timed topic API 엔드포인트를 사용하려고 했는데, 몇 가지 필드에 대해 조금 혼란스럽습니다.

  • id 경로 매개변수 - 직관적입니다. 예약되는 주제의 ID입니다.
  • time - 이 필드는 어떤 형식이어야 하나요? 문서에는 단순히 "string"이라고만 나와 있습니다.
  • status_type - 가능한 값이 무엇인지 확실하지 않습니다. 상태 업데이트 API의 status enum과 유사할 것 같지만, 타이머의 예시에는 enum에 없는 "publish_to_category"라는 값이 사용되어 있습니다.
  • based_on_last_post - 이 boolean 플래그가 무엇을 의미하는지 전혀 모르겠습니다.
  • category_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

models/topic.rb의 set_or_create_timer 메서드에는 이 API를 지원하는 로직이 포함되어 있습니다.