Explications du champ de sujet chronométré sur l'API

Pour mon projet, je souhaite créer programmablement des sujets planifiés. J’envisage d’utiliser le point de terminaison de l’API des sujets temporisés, mais je suis un peu confus concernant certains champs.

  • paramètre de chemin id – simple, l’identifiant du sujet à planifier
  • time – quel format est attendu ? Il est simplement indiqué « string ».
  • status_type – je ne suis pas sûr des valeurs possibles. Je pensais qu’il serait similaire à l’énumération de statut dans l’API de mise à jour du statut, mais l’exemple sur le minuteur est « publish_to_category », qui n’est pas une option dans l’énumération.
  • based_on_last_post – je n’ai aucune idée de ce que signifie ce drapeau booléen
  • category_id – simple

app/models/topic_timer.rb :

close
open
publish_to_category
delete
reminder
bump
delete_replies

J’ai trouvé un commentaire dans le code :

  • Un entier représentant le nombre d’heures à partir de maintenant pour mettre à jour le statut du sujet.
  • Un horodatage, comme “2013-11-25 13:00”, indiquant quand le statut du sujet doit être mis à jour.
  • Un horodatage avec fuseau horaire au format JSON. (par exemple, “2013-11-26T21:00:00.000Z”)
  • based_on_last_post : Vrai si le temps doit être basé sur l’horodatage du dernier message.
2 « J'aime »

Merci pour la référence aux commentaires : discourse/app/models/topic.rb at 0863c36221130b161d63562a58ac97171475dca5 · discourse/discourse · GitHub

La méthode set_or_create_timer dans models/topic.rb contient la logique prenant en charge cette API.

1 « J'aime »