Docs: API docs with or w/o swagger

[samip5]

It would help a lot if there was a swagger API docs that would have examples of how to actually call the JSONRPC API and/or events API.

Postman collection would also help.

[vktr]

All the JSONRPC methods are documented at porla.org - for example, torrents.list. Since it's JSONRPC I've just documented the payloads and responses and not the JSONRPC stuffs, but I should probably do some example request/responses in the top level docs for the JSONRPC API.

The events API is documented here - https://porla.org/api/events#monitoring-using-curl but should probably be expanded with an example that uses the auth token as well.

[samip5]

Yes, the issue that I encountered when looking at the docs was simply that there was no curl examples of calling any of them, which made it very hard to understand how to call them.

[vktr]

I've added an issue in the docs repo - porla/docs#6. I'm closing this in favor of that 😃