A melhor documentação para a API é o Discourse. Veja Como fazer engenharia reversa da API do Discourse