Discourse è supportato da una completa API JSON. Tutto ciò che puoi fare sul sito puoi farlo anche utilizzando l’API JSON.
L’API è documentata su docs.discourse.org. Puoi anche utilizzare la gem Ruby discourse_api come libreria client. Tuttavia, non tutti gli endpoint sono documentati.
Per determinare come eseguire un’operazione con l’API JSON, puoi seguire questi passaggi.
Esempio: ricategorizzare un argomento.
- Vai a un argomento e inizia a modificare una categoria:
- Apri gli strumenti di sviluppo di Chrome, passa alla scheda Network, seleziona il filtro Fetch/XHR:
- Esegui l’operazione
- I dati della richiesta verranno mostrati nella scheda “Payload”
- Controlla anche l’anteprima per capire i risultati
- Ora hai tutte le informazioni necessarie.
-
L’endpoint è
https://try.discourse.org/t/online-learning/108.json -
Il Payload viene passato usando un
PUT -
Il parametro inviato è:
category_id: 5
Con queste informazioni puoi effettuare le tue chiamate utilizzando il tuo linguaggio di programmazione preferito. Tutto ciò che devi fare è aggiungere il tuo Api-Username e Api-Key agli header della richiesta. (Vedi Discourse REST API Documentation per i dettagli su come formulare una richiesta curl all’API di Discourse.)
Le credenziali API possono essere generate dal pannello di amministrazione in /admin/api/keys:
