O Discourse é suportado por uma API JSON completa. Tudo o que você pode fazer no site, você também pode fazer usando a API JSON.
A API está documentada em docs.discourse.org. Você também pode usar a gem Ruby discourse_api como uma biblioteca cliente. No entanto, nem todos os endpoints estão documentados.
Para determinar como fazer algo com a API JSON, siga estas etapas.
Exemplo: recategorizar um tópico.
- Vá a um tópico e comece a editar uma categoria:
- Abra as ferramentas de desenvolvedor do Chrome, mude para a aba Network (Rede), selecione o filtro Fetch/XHR:
- Execute a operação
- Os dados da requisição serão mostrados na aba “Payload” (Carga útil)
- Verifique também a prévia para descobrir os resultados
- Agora você tem todas as informações de que precisa.
-
O endpoint é
https://try.discourse.org/t/online-learning/108.json -
A Payload é passada usando um
PUT -
O parâmetro enviado é:
category_id: 5
Com essas informações, você pode fazer suas próprias chamadas usando sua linguagem de programação favorita. Tudo o que você precisa fazer é adicionar seu Api-Username e Api-Key aos cabeçalhos da requisição. (Veja Discourse REST API Documentation para detalhes sobre como formular uma requisição curl para a API do Discourse.)
As credenciais da API podem ser geradas no painel de administração em /admin/api/keys:
