The discussion revolves around challenges with pagination in the Discourse API, particularly when using search/query.json to retrieve posts within a date range. danielt initially struggled with pagination, noting that page 2 and page 3 returned identical results for complex queries, unlike simpler searches. vinothkannans clarified that the query string should use & instead of ? for subsequent pages, correcting the URL structure. pfaffman shared a Ruby script for downloading topics, though it doesn’t handle date filtering. danielt acknowledged the mistake in URL formatting and questioned how to access additional posts when more_posts is true. sam confirmed pagination support and referenced the Discourse API documentation. faheem asked about the meaning of term in the API, and blake explained that term refers to a search query, not a time period, and suggested reverse-engineering the UI’s API calls to understand pagination. faheem expressed a desire to fetch all topics in a category at once, but blake clarified that multiple API calls are necessary due to performance constraints, and suggested using data explore queries as an alternative.
I don’t know if it’ll help, but I wrote a little ruby program that will download all of a topic or category. (It doesn’t pay attention to dates, though.)
Oops. Getting the links wrong is what made me believe discourse support pagination using page=X in the first place (my own bad conversion from curl to a web browser).
Perhaps I should have ask a more general question: If search/query.json has a grouped_search_result with more_posts set true, how do I get to see the additional posts?
Я пытаюсь разобраться, как использовать API Discourse.
В приведенных ниже URL-адресах я предполагаю, что term относится к периоду или временному диапазону. Это следует из примеров вроде term=after:2016-01-01%20before:2017-01-01 и т. д. Но я не понимаю, что означает term=API. Кто-нибудь может прояснить?
На самом деле существует два поисковых эндпоинта, к которым можно обратиться: /search.json?q= и /search/query?term=.
term просто означает поисковый запрос и не относится к периоду или длительности.
Для понимания поискового API лучше всего следовать руководству по адресу Reverse engineer the Discourse API, выполнить через API те поисковые запросы, которые вы планируете использовать, и посмотреть, как интерфейс выполняет аналогичные запросы к API.
На самом деле, я хочу получить полное содержимое страницы (в моём случае — список тем в категории, см. Obtaining a list of topics from a category). Мне не нужно переходить по страницам, если это не обязательно. И я не думаю, что реверс-инжиниринг здесь поможет, поскольку Discourse просто подгружает контент по мере прокрутки страницы. Насколько мне известно, нет опции для отображения всей страницы сразу. Есть ли способ это сделать?
Не существует единственного вызова API, который мог бы получить ВСЕ темы категории. Вам придется выполнить несколько вызовов API. Это связано с тем, что в категории может быть более 1 миллиона тем, и такой запрос может быть очень большим и повлиять на производительность вашего сайта. При реверс-инжиниринге прокрутки вы можете увидеть, как интерфейс Discourse выполняет вызовы API для получения дополнительных тем, и воспроизвести это поведение в вашем API.
В зависимости от того, чего вы пытаетесь достичь, вы также можете использовать запрос Data Explore для получения количества тем в категории и выполнить вызов API к этому сохраненному запросу.