Atualizar um Post, via API PUT: request

Dev
1

Só para entender, a documentação da API do Discourse menciona esse tipo de… estrutura…

{
"post[raw]": "string",
"post[raw_old]": "string",
"post[edit_reason]": "string",
"post[cooked]": "string"
}

Antes de tentar isso, isso significa, ou bem… o que isso significa?

Isso significa: {post: {raw: ..., raw_old: ... }}

Ou simplesmente {raw: "", raw_old: ""...}

E também, o que é raw_old? Só diz que cada elemento é uma “string” do que devo enviar (PUT) no corpo JSON.

Estou apenas tentando adicionar uma linha no topo da postagem (que foi criada inicialmente por um Bot), onde precisamos adicionar um link para outro site. Note também que, com o objetivo de ter esse primeiro parágrafo exibido abaixo do título da Categoria, ou no elemento cooked

a ser mostrado (definido logo abaixo do título da categoria).

Espero que isso faça sentido. Se não, peça para eu esclarecer.

2

No momento, não tenho certeza absoluta para que serve o raw_old, mas você só precisa usar o campo raw e ele substituirá a postagem inteira. Portanto, no seu código, você buscaria a postagem que deseja editar, adicionaria sua linha no topo e, em seguida, atualizaria a postagem usando o campo raw.

Pode ser útil ver como o Discourse faz isso editando uma postagem ao vivo no seu site e inspecionando as chamadas do navegador:

É assim que o gem discourse_api também faz:

3

Só uma pergunta sobre isso: você está se referindo a uma documentação diferente daquela definida em Discourse API Docs? Isso seria interessante… no entanto, estou me baseando apenas na documentação da API.

Meu objetivo simples é apenas adicionar um comentário e um link abaixo do nome da categoria, o que, acredito, o Discourse obtém do primeiro post do tópico “Sobre…”. Estou apenas procurando saber o que será inserido no elemento

… ou o que preciso fazer para que meu post apareça lá. Minha explicação faz sentido?

4

Pelo exposto acima e pelas minhas tentativas, não é possível atualizar uma postagem usando “cooked”, conforme afirma a documentação da API. No entanto, é possível fazê-lo com “raw”. Todas as minhas tentativas usando “cooked” resultaram em um erro indicando que a postagem era inválida por ter menos de 20 caracteres ou não ser uma frase clara…

No entanto, há problemas adicionais com “raw” que abordarei em outra postagem, pois não estão diretamente relacionados a este assunto.

Obrigado por toda a ajuda.

5

Há uma pequena discrepância na Documentação da API:

A documentação diz: PUT /posts/{id}.json com payload

Tipo de conteúdo: application/json

{
  "post[raw]": "string",
  "post[raw_old]": "string",
  "post[edit_reason]": "string",
  "post[cooked]": "string"
}

mas isso só funciona com PUT /posts/{id} e Content-Type: application/x-www-form-urlencoded.

O payload correto para PUT /posts/{id}.json deve ser:

Tipo de conteúdo: application/json

{
  "post": {
      "raw": "string",
      "raw_old": "string",
      "edit_reason": "string",
      "cooked": "string"
    }
}

O parâmetro raw é suficiente para substituir toda a postagem.

7

Sim, obrigado. Percebi isso após tentar algumas requisições no Postman e brincar um pouco com isso… também, nas minhas tentativas, o “cooked” parecia não fazer nada… e ainda não tenho certeza do que é o “raw_old”.

9

Isso foi adiado hoje e está atribuído a mim. Talvez possa ser desatribuído :slight_smile:

De qualquer forma, a documentação agora está correta: Discourse API Docs.