# frozen_string_literal: true module DiscourseApi module API module Topics # :category OPTIONAL name of category, not ID # :skip_validations OPTIONAL boolean # :auto_track OPTIONAL boolean # :created_at OPTIONAL seconds since epoch. def create_topic(args = {}) args = API .params(args) .required(:title, :raw) .optional(:skip_validations, :category, :auto_track, :created_at, :api_username, :tags) post("/posts", args.to_h) end def create_topic_action(args) args = API.params(args).required(:id, :post_action_type_id) post("/post_actions", args.to_h.merge(flag_topic: true)) end # timestamp is seconds past the epoch. def edit_topic_timestamp(topic_id, timestamp) put("/t/#{topic_id}/change-timestamp", timestamp: timestamp) end def latest_topics(params = {}) response = get("/latest.json", params) response[:body]["topic_list"]["topics"] end def top_topics(params = {}) response = get("/top.json", params) response[:body]["topic_list"]["topics"] end def new_topics(params = {}) response = get("/new.json", params) response[:body]["topic_list"]["topics"] end def rename_topic(topic_id, title) put("/t/#{topic_id}.json", topic_id: topic_id, title: title) end def recategorize_topic(topic_id, category_id) put("/t/#{topic_id}.json", topic_id: topic_id, category_id: category_id) end # TODO: Deprecated. Remove after 20201231 def change_topic_status(topic_slug, topic_id, params = {}) deprecated(__method__, "update_topic_status") update_topic_status(topic_id, params) end def update_topic_status(topic_id, params = {}) params = API.params(params).required(:status, :enabled).optional(:api_username) put("/t/#{topic_id}/status", params) end def topic(id, params = {}) response = get("/t/#{id}.json", params) response[:body] end def topics_by(username, params = {}) response = get("/topics/created-by/#{username}.json", params) response[:body]["topic_list"]["topics"] end def delete_topic(id) delete("/t/#{id}.json") end def topic_posts(topic_id, post_ids = [], params = {}) params = API.params(params).optional( :asc, :filter, :include_raw, :include_suggested, :post_number, :username_filters, ) url = ["/t/#{topic_id}/posts.json"] if post_ids.count > 0 url.push("?") url.push(post_ids.map { |id| "post_ids[]=#{id}" }.join("&")) end response = get(url.join, params) response[:body] end def change_owner(topic_id, params = {}) params = API.params(params).required(:username, :post_ids) post("/t/#{topic_id}/change-owner.json", params) end def topic_set_user_notification_level(topic_id, params) params = API.params(params).required(:notification_level) post("/t/#{topic_id}/notifications", params) end def bookmark_topic(topic_id) put("/t/#{topic_id}/bookmark.json") end def remove_topic_bookmark(topic_id) put("/t/#{topic_id}/remove_bookmarks.json") end end end end