Como posso filtrar/paginar a lista da rota CategoryTopics?

Estamos construindo uma integração personalizada para nossa instância do Discourse auto-hospedada dentro de nosso aplicativo e gostaríamos de filtrar os resultados de https://docs.discourse.org/#tag/Categories/operation/listCategoryTopics para nos permitir mostrar os tópicos mais recentes e principais. Atualmente, ele é paginado para 30 índices por página.

Precisamos de uma das seguintes opções:

  1. Filtrar os resultados para que os 30 índices retornados sejam os tópicos mais recentes ou principais (ideal)
  2. Aumentar o limite de paginação para fazer essa filtragem/ordenação no cliente (não ideal, mas funcionaria)

Obrigado antecipadamente!

Olá,

Acredito que o que você procura é isto:

/c/{slug}/{id}/l/{filter}.json?{query}

Onde:

{filter} é um dos seguintes:

latest
unread
new
unseen
top
read
posted
bookmarks

{query} pode ser (provavelmente não exaustivo):

page=<int>
before=<timestamp>
bumped_before=<timestamp>
topic_ids=<id1[,id2, ..]>
order=<likes|op_likes|views|posts|activity|posters|category|created>
ascending=<true|false>
min_posts=<int>
max_posts=<int>
status=<open|closed|archived|listed|unlisted|deleted>
state=<muted|regular|normal|tracking|watching>
search=<term>
subset=<topics|replied>
tags=<tag1[,tag2,..]>
match_all_tags=<true|false>
no_subcategories=<true|false>
no_tags=<true|false>
exclude_tag=<tag>

Parece que você não pode alterar o per_page com a API.

Você pode brincar com order e paginar com page. Você pode saber a próxima URL a ser usada usando more_topic_url, veja abaixo no exemplo de resposta:

Vale a pena notar: Experimental topics list filter feature

Espero que ajude!