Cambiamenti del corpo della risposta /search/query per motivo sconosciuto

Sviluppatore
1

Ciao!

Abbiamo implementato una funzionalità sul nostro sito che interroga i nostri forum Discourse ospitati e visualizza le informazioni sugli argomenti trovati. Funzionava perfettamente la scorsa settimana dopo il deployment, ma si è interrotta nel weekend. Sembra che la struttura degli oggetti topic restituiti dalla query sia cambiata notevolmente.

Oggetto di risposta atteso, basato sui test effettuati durante lo sviluppo e coerente con la documentazione più 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
        }
    ],

Risposta effettiva/attuale:

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

Mi chiedo se sia stato rilasciato un aggiornamento che ha modificato le risposte dell’API di ricerca? O, più probabilmente, se qualcuno sia a conoscenza di un’impostazione di amministrazione che potrebbe causare questo comportamento?

Ho esaminato il registro delle modifiche per l’ultima versione (2.5 rilasciata il 24 giugno), ma non ho trovato nulla che menzioni specificamente un cambiamento nell’API.

Grazie in anticipo per qualsiasi aiuto.

  • Carey
2

Sì, di recente sono stati rimossi dal payload restituito per le richieste di ricerca i seguenti attributi del topic:

    image_url
    thumbnails
    title
    created_at
    last_posted_at
    bumped_at
    bumped
    highest_post_number
    reply_count
    unseen

Questa modifica è stata apportata per motivi di prestazioni. Puoi comunque ottenere il titolo tramite l’attributo fancy_title. Aggiorneremo la documentazione per riflettere questa modifica.

3

Grazie mille @simon,

Grazie per il chiarimento. Per fortuna stavamo già usando fancy_title. È stato created_at a causarci problemi.

Ah, quindi deve essere questo elemento nelle note di rilascio: Miglioramento delle prestazioni dell'elenco dei topic per categoria!

C’è un posto dove posso tenere d’occhio le modifiche imminenti all’API?

Grazie ancora per il rapido aiuto.

  • Carey
4

Mi dispiace, al momento non c’è nulla, a parte le note di rilascio e le modifiche git, ma stiamo certamente riflettendo su questo problema.

5

@th3coop La rimozione di quei campi è stata annullata, poiché sono considerati API pubbliche, come indicato all’indirizzo Discourse API Docs.

6

Grazie per l’avviso, @tgxworld. Ammetto che è stato un po’ sconcertante vedere l’API cambiare improvvisamente senza preavviso.

Grazie per la rapida risoluzione!

  • Carey