freechat/server-api/endpoints.md
2020-12-22 21:52:30 -08:00

1.1 KiB

Documenting the currently tested / working endpoints

Mostly a dev reference for now since it's a lot more terse.

Parameters

All parameters are to be passed in via json, other parameters are ignored

Auth

Basically every endpoint except for /join and /meta require the folowing auth data at a bare minimum.

  • id: u64 -> User id [ Public to the instance ]

  • jwt: String

To get a JWT you must POST /login with the following:

  • id: u64 -> User id [ Public to the instance ]

  • secret: String -> Server generated password

Chat api

/channels/list NoPermsRequired

No parameters required

/channels/create RequiredPerm[CREATE_CHANNEL=64]

  • @Required name: String

  • @Required kind: Signed 32-bit Integer

  • @Optional description: String

For voice channel 1. For text channel 2. All other options result in a HTTP 400.

/channels/delete RequiredPerm[DELETE_CHANNEL=128]

  • @Required channel_id: Unsigned 64-bit Integer

/message/send RequiredPerm[SEND_MESSAGES=2]

  • @Required channel Unsigned 64-bit Integer

  • @Required content String