Changements du corps de réponse de la requête /search/query pour une raison inconnue

Dev
1

Salut !

Nous avons développé une fonctionnalité sur notre site web qui interroge nos forums Discourse hébergés et affiche des informations sur les sujets trouvés. Tout fonctionnait parfaitement la semaine dernière lors du déploiement, mais cela a cessé de fonctionner durant le week-end. Il s’avère que la structure des objets topic renvoyés par la requête a considérablement changé.

Objet de réponse attendu, basé sur les tests effectués durant le développement et correspondant également à la documentation la plus récente :

"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
        }
    ],

Réponse actuelle :

 "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
        }
    ],

Je me demande si une mise à jour a été publiée modifiant les réponses de l’API de recherche ? Ou plus probablement, si quelqu’un connaît un paramètre d’administration qui pourrait en être la cause ?

J’ai consulté le journal des modifications de la dernière version (2.5 publiée le 24 juin), mais je n’ai rien trouvé mentionnant spécifiquement un changement d’API.

Merci d’avance pour toute aide.

  • Carey
2

Oui, les attributs de sujet suivants ont récemment été supprimés de la charge utile renvoyée pour les requêtes de recherche :

    image_url
    thumbnails
    title
    created_at
    last_posted_at
    bumped_at
    bumped
    highest_post_number
    reply_count
    unseen

Ce changement a été apporté pour des raisons de performance. Vous pouvez toujours obtenir le titre grâce à l’attribut fancy_title. Nous mettrons à jour la documentation pour refléter ce changement.

3

Merci beaucoup @simon,

Merci pour les précisions. Heureusement, nous utilisions déjà fancy_title. C’est created_at qui nous a posé problème.

Ah, cela doit donc être cet élément des notes de version : Améliorer les performances de la liste des sujets par catégorie !

Y a-t-il un endroit où je peux surveiller les changements API à venir ?

Merci encore pour votre aide rapide.

  • Carey
4

Désolé, pas pour le moment, à part les notes de version et les modifications git, mais nous réfléchissons certainement à ce problème.

5

@th3coop La suppression de ces champs a été annulée, car ces champs sont considérés comme faisant partie de l’API publique, conformément à Discourse API Docs.

6

Merci pour l’info, @tgxworld. Je reconnais que c’était un peu inquiétant de voir l’API changer soudainement sans préavis.

Merci pour la résolution rapide !

  • Carey