O que é um Post? (Pergunta sobre a API do Discourse)

[jcasman (Jesse Casman)]

Estou tentando avaliar e relatar com precisão a atividade de um fórum que estou administrando usando o Discourse. Acredito que não compreendo fundamentalmente o que é um Post.

Na API, existem Tópicos e Posts. Por exemplo, se eu quiser obter Posts, posso usar filter=5

/user_actions.json?offset=0&username=USERNAME&filter=5

(Alguém pode me dizer o que é “offset”?)

Aqui está o mistério. Os Posts não parecem incluir Tópicos. Esse é o comportamento esperado?

O que são Posts em relação às Respostas? Eles não parecem ser um superconjunto.

Os Posts na API são os mesmos que obtemos no relatório (Admin → Relatórios → Posts)?

Qualquer ajuda é apreciada.

[codetricity (Craig Oda)]

Pelo que pude verificar, o parâmetro filter=5 para postagens em /user_actions.json?offset=0&username=USERNAME&filter=5 não corresponde às Postagens no relatório. Parece que as Postagens no relatório incluem tanto as postagens (filter=5) quanto os tópicos (filter=4).

Estou assumindo que as postagens deveriam ser respostas + tópicos. Seria ótimo se alguém mais experiente pudesse confirmar isso.

Se for esse o caso, posso tentar usar respostas (filter=6) e tópicos (filter=4). No entanto, estou um pouco preocupado com isso, pois o relatório no painel do Discourse está apresentando os números corretos e esperados.

Tente buscar um exemplo de uso da API do Discourse para gerar relatórios.

[JimPas]

@jcasman

Parece que as publicações não incluem os tópicos. Esse é o comportamento esperado?

Sim, as publicações estão dentro de um tópico. Portanto, pesquisar por novas publicações não buscará novos tópicos.

@jcasman

O que são publicações em relação às respostas?

Quando você cria um tópico, também cria uma publicação — a primeira publicação faz parte do tópico.
No entanto, todas as respostas subsequentes também são consideradas publicações — você está publicando suas respostas.

Quanto ao offset e se as publicações na API são as mesmas em Admin → Relatórios → Publicações, vou deixar isso para outra pessoa.

[JammyDodger]

Isso ajuda?

(Superseded) The difference between Topics and Posts

This has been superseded by parts of the Discourse New User Guide Inspired by this answer by @jomaxro, this is a short explainer on the difference between topics and posts in Discourse. Topics are collections of posts. Let’s use a random topic here on Meta as an example: That topic has a title, “Don’t warn whisperers”, and ID, 199028 , and contains 5 posts at the time of writing this howto. Posts are the individual “content” within a topic. This includes the “OP”, or…

[codetricity (Craig Oda)]

@JimPas

Quando você cria um Tópico, também cria uma Postagem — a primeira Postagem faz parte do Tópico.
No entanto, todas as Respostas subsequentes também são consideradas Postagens — você está postando suas respostas.

Primeiro, obrigado pela sua ajuda.

Ao usar /user_actions.json?offset=0&username=USERNAME&filter=5, parece que não estou obtendo uma contagem de postagem se ela foi a primeira postagem de um tópico.

Pode ser que eu esteja usando a API incorretamente.

Tenho uma conta de teste com 7 atividades.

• 3 tópicos, cada um com uma postagem
• 4 respostas a tópicos existentes.

Quando filtro por “postagens”, obtenho uma contagem de 4, e não os 7 esperados.

Para obter a contagem esperada de 7 postagens, acho que preciso adicionar “respostas” e “tópicos”.

Pelo que entendi, acho que o filter de 5 deve retornar tanto as postagens que são a primeira postagem de um tópico quanto as respostas, certo?

Gostaria muito de ajuda para entender como obter a contagem de postagens de usuários específicos usando a API.

 query = {'username': username, 'filter': '5'};

  var response = await getRequest(
      path: '/user_actions.json',
      queryParameters: query);

[JimPas]

@codetricity

Parece que não estou tendo uma postagem contabilizada quando ela é a primeira postagem de um tópico.

Isso está correto. Todos os tópicos têm uma primeira postagem como parte da criação do tópico. Não seria possível criar um tópico com apenas um cabeçalho. Essa primeira postagem não é contabilizada como uma postagem (resposta) em uma consulta de postagens (filtro-5).

Quando você consulta postagens, isso se refere a novas respostas para tópicos existentes — excluindo o OP (autor original). Esse é o comportamento esperado: mostrar apenas as postagens novas.

Para incluir tópicos (criados por esse usuário) como parte da consulta, o Filtro=4 deve retornar os tópicos que o usuário criou (incluindo os OPs como parte da contagem [3]) e suas respostas [4]. Isso retornaria os 7 que você vê no relatório: 3 tópicos criados + 4 respostas, totalizando 7 (3 OPs + 4 respostas).

Se alguém mais conhecedor quiser contribuir, fique à vontade para intervir.

[codetricity (Craig Oda)]

@JimPas

Isso está correto. Todos os tópicos têm uma primeira postagem como parte da criação do tópico. Não faria sentido criar um tópico apenas com o cabeçalho. Essa primeira postagem não é contabilizada como uma postagem (resposta) em uma consulta de postagem (filtro-5).

@JimPas, obrigado pela sua ajuda. É muito útil. Com esse conhecimento, estou avançando com o painel do aplicativo com mais confiança. Tenha um bom dia. Foi muito gentil da sua parte ajudar um estranho como eu.

[jcasman (Jesse Casman)]

Aqui também, @JimPas, muito útil e muito apreciado. Obrigado.