User Management

Getting a user

Either username or user_id is required when getting a user profile, user_id is preferred.

REQ:

{
  "type": "get_user_data",
  "id": "<uuid>",

  "data": {
      "username": "<username>",
      "user_id": "<user id>"
  }
}

RES:

{
  "type": "get_user_data",
  "id": "<uuid>",

  "data": {
    "user_id": user id,
    "iota_id": iota id,
     "created_at": int, // UNIX Timestamp
    "username": "<username>",
    "display": "<display name>",
    "avatar": "<base64 avatar>",
    "about": "<base64 about>",
    "status": "<status>",
    "public_key": "<base64 public key>",
    "sub_level": int,
    "sub_end": int
  }
}

Change Data about user

REQ:

{
  "type": "change_user_data",
  "id": "<uuid>",

  "data": {
    "user_id": int,

    "public_key": "",
    "username": "",
    "display": "",
    "avatar": "",
    "about": "",
    "status": ""
  }
}

RES:

{
  "type": "success",
  "id": "<uuid>"
}

Changing the iota

Provide the users current and new Reset-Token.

REQ:

{
  "type": "change_user_data",
  "id": "<uuid>",

  "data": {
    "iota_id": "<uuid>",
    "reset_token": "<base64 random bytes>",
    "new_token": "<base64 random bytes>"
  }
}

RES:

{
  "type": "success",
  "id": "<uuid>"
}

Get a Register-ID

You can use this to register a User or Iota. The User-creation process timeouts after 1 hour.

REQ:

{
  "type": "get_register",
  "id": "<uuid>"
}

RES:

{
  "type": "get_register",
  "id": "<uuid>",
  "data": {
    "register_id": id (unix timestamp)
  }
}

Complete a Registration

Complete a registration, both for Iota’s and User’s.

User:

REQ:

{
  "type": "complete_register_user",
  "id": "<uuid>",

  "data": {
    "user_id": id (must be provided by get_register),
    "username": "",
    "public_key": "",
    "username": "",
    "iota_id": id,
    "reset_token": ""
  }
}

RES:

{
  "type": "success"
}

Iota:

REQ:

{
  "type": "complete_register_iota",
  "id": "<uuid>",

  "data": {
    "iota_id": id,
    "public_key": "<base64 public key>"
  }
}

RES:

{
  "type": "success"
}

Delete a User

REQ:

{
  "type": "delete_profile",
  "id": "<uuid>",

  "data": {
    "user_id": id
  }
}

RES:

{
  "type": "success"
}

Delete an Iota

REQ:

{
  "type": "delet_profile",
  "id": "<uuid>",

  "data": {
    "iota_id": id
  }
}

RES:

{
  "type": "success"
}