freechat/docs/content/endpoints/invites.md
shockrah 975acfd606 Backend REST API changes:
* Fixed weird match with get_online_members
+ Now using special(smoll) Public Member struct for public member data fetches as.
They're size on networks should be pretty small so we can package a ton of them in a single request

DOCS changes:
- Removing references to unix timestamps in seconds
- Removing references to joindate
* Exact content-type values now specified
2021-03-20 22:44:22 -07:00

1.2 KiB

title anchor weight
Invites invites-ep 16

POST /invite/create

  • Required permissions:

    • CREATE_TMP_INVITES
      • Base requirement
    • CREATE_PERM_INVITES
      • Additional requirement for permanent invite codes
  • Required query string parameters:

    • id: u64
    • jwt: string
  • Returns

    • id: i64

    • uses: Optional This field is really meant for servers and really doesn't have much use to users. It just to keep track of whether or not an invite has been used too many times or not.

    • expires: boolean

Example

	> POST /invite/create?id=123&jwt=

	< { 
	<	"id": <unix-timestamp ms>, 
	<	"uses": 3, 
	<	"expires": true
	< }

GET /join

  • Required Permissions

    • None
  • Required query string parameters:

    • code: i64
  • Returns a new member account - The account details are not behind a key in the JSON object, so the resulting data is completely flat, for JSON.

    • id: u64
    • secret: String
    • name: String
    • joindate: i64
    • status: i32
    • permissions: u64
  • Default values

    • status: 0
    • permissions: 51
    • name: Anonymous

Example

	> GET /join?code=123456

	< { 
	<	"id": 123,
	<	"secret": "super secret",
	<	"name": "Anonymous",
	<	"status": 0,
	<	"permissions": 51
	< }