Hi everybody!
I hope that everyone's night is going well. So I have a couple of small questions.
A little about me as a user for context: I am currently trying to develop a webapp which requires a messenger system similar to slack. While I was doing a little bit of research, an awesome friend of mine suggested to me to checkout Mattermost, and it seems to offer exactly the messenger services that we need. So now we need to figure out how exactly to integrate Mattermost with our own backend.
Now, I would like to give a small disclosure: much like Jon Snow, I know nothing. Chances are that the issue we're having is an imaginary one (like my friends) and there is already an answer out there (maybe the webhooks? I must admit that I don't understand them fully (and would love a clarification), but I don't think that they have the full scope of functions we want).
So moving on, we're trying to write the backend in node (using express), and what we would like to have is a running Mattermost server which we can call to access several of its services services. As such, we want to use the Mattermost API to perform certain actions. Now here, I would like to be abundantly clear: we are looking for the Restful API, not a driver, and the most complete one at that. Not only do we want to get and post messages, but we also want to view teams, create teams, register users, etc... An example of what we are currently looking for is something similar to, for example, the imgur API. Again, we could be missing something very important right now, so please call us out if you already have an answer.
We looked in-depth at the current API page, as well as all of its links (incuding the one to the Web Service API), and we found the documentation kind of lacking-- we now know how to do an authentication call, but that's pretty much it. Our research did not stop there, and we tried to look at issues raised, feature requests, forum posts (there's a couple more unlisted references), and it seems that there is a general consensus that there is currently no such documentation. The sources we looked at generally instructed us to inspect the source to understand the endpoints, and I think that we found them:
Sadly, none of these handlers (and the others not seen) seem to have any documentation. My question then is: have I been wrong in my train of thought so far, and if not is there any objections to me to try to fill in the documentation? I, of course, do not out-right expect for such documentation to be fully accepted, but would you guys, the Mattermost in-house developers, be amenable to considering such help? This is a really cool project, and I think that such documentation can go a long way for user adoption.
So yeah, that pretty much covers my rant. Sorry that it took so long-- I wanted to be very clear and thorough. Thank you for your time, and have a nice night!