Alterações no corpo da resposta de /search/query por motivo desconhecido

Dev
1

Olá!

Desenvolvemos um recurso em nosso site que consulta nossos fóruns Discourse hospedados e exibe informações sobre os tópicos encontrados. Tudo funcionava perfeitamente na semana passada, quando implementamos, mas parou de funcionar no fim de semana. Acontece que os objetos topic retornados pela consulta mudaram bastante de estrutura.

Objeto de resposta esperado, com base nos testes durante o desenvolvimento e que também correspondia à documentação mais recente:

"topics": [
        {
            "id": 1099,
            "title": "Build Error: ipykernel 4.8.2 for python 3.6.6 on Windows",
            "fancy_title": "Build Error: ipykernel 4.8.2 for python 3.6.6 on Windows",
            "slug": "build-error-ipykernel-4-8-2-for-python-3-6-6-on-windows",
            "posts_count": 1,
            "reply_count": 0,
            "highest_post_number": 1,
            "image_url": null,
            "created_at": "2020-06-30T23:36:42.277Z",
            "last_posted_at": "2020-06-30T23:36:42.357Z",
            "bumped": true,
            "bumped_at": "2020-06-30T23:36:42.357Z",
            "archetype": "regular",
            "unseen": false,
            "pinned": false,
            "unpinned": null,
            "visible": true,
            "closed": false,
            "archived": false,
            "bookmarked": null,
            "liked": null,
            "thumbnails": null,
            "tags": [
                "windows",
                "builder"
            ],
            "category_id": 1,
            "has_accepted_answer": false
        }
    ],

Resposta atual/real:

 "topics": [
        {
            "id": 1494,
            "fancy_title": "Build Error: python-magic 0.4.15 for Python 3.8.2 on Mac",
            "slug": "build-error-python-magic-0-4-15-for-python-3-8-2-on-mac",
            "posts_count": 1,
            "archetype": "regular",
            "pinned": false,
            "unpinned": null,
            "visible": true,
            "closed": false,
            "archived": false,
            "bookmarked": null,
            "liked": null,
            "tags": [
                "mac",
                "builder"
            ],
            "category_id": 1,
            "has_accepted_answer": false
        }
    ],

Estou me perguntando se talvez tenha sido lançada uma atualização que alterou as respostas da API de pesquisa? Ou, mais provavelmente, se alguém tem conhecimento de uma configuração de administração que possa causar isso?

Verifiquei o registro de alterações da última versão (2.5 lançada em 24 de junho), mas não encontrei nada que mencione especificamente uma alteração na API.

Agradeço antecipadamente por qualquer ajuda.

  • Carey
2

Sim, os seguintes atributos de tópico foram recentemente removidos do payload retornado para solicitações de busca:

    image_url
    thumbnails
    title
    created_at
    last_posted_at
    bumped_at
    bumped
    highest_post_number
    reply_count
    unseen

Essa alteração foi feita por motivos de desempenho. Você ainda pode obter o título com o atributo fancy_title. Vamos atualizar a documentação para refletir essa mudança.

3

Muito obrigado, @simon,

Obrigado pela esclarecimento. Felizmente, já estávamos usando fancy_title. O que nos deu dor de cabeça foi created_at.

Ah, então deve ter sido este item nas Notas de Lançamento: Melhorar o desempenho da lista de tópicos da categoria!

Existe algum lugar onde eu possa acompanhar as mudanças futuras na API?

Obrigado novamente pela rápida assistência.

  • Carey
4

Desculpe, por enquanto não, exceto pelas notas de versão e alterações no git, mas certamente estamos pensando nesse problema.

5

@th3coop A remoção desses campos foi revertida, pois esses campos são considerados API pública, conforme Discourse API Docs.

6

Obrigado pelo aviso, @tgxworld. Admito que foi um pouco desconcertante ter a API alterada repentinamente sem aviso prévio.

Obrigado pela resolução rápida!

  • Carey