get_current_account

get_current_account() returns the current account authorization context as the public blaze::account result object.

Function variants

blaze::account get_current_account();
blaze::account get_current_account(std::error_code& ec) noexcept;
void async_get_current_account(std::function<void(std::error_code, blaze::account)> callback);
blaze::coro::awaitable_result<blaze::account> co_get_current_account();

Status vs error

account.status is the API result. std::error_code and std::system_error are used for transport/runtime failures only.

Result

struct account {
  std::string login;
  std::vector<std::string> levels;
  std::string comment;
  std::string ip_address;
  std::chrono::seconds time_left{};
  bool license_required{};
  blaze::status status{};

  bool good() const noexcept;
  bool already_authorized() const noexcept;
};

Prop

Type

account.good() is equivalent to status == blaze::status::ok.

Checking returned fields

Missing fields are returned as default values. If account.status != blaze::status::ok, treat metadata fields as optional in practice and check them explicitly.

Field	Practical check
`account.login`	`account.login.empty()`
`account.levels`	`account.levels.empty()`
`account.comment`	`account.comment.empty()`
`account.ip_address`	`account.ip_address.empty()`
`account.time_left`	`account.time_left.count() == 0`
`account.license_required`	Use `account.status == blaze::status::ok` before relying on it. `false` alone is not a reliable "missing field" check.

Behavior notes

Call get_current_account only after successful connect and initialize.
This method reads the current in-session account context. It does not perform a new authorization request.
It works only for credential-based authorization context. If the session is not authorized by credentials, the operation returns blaze::status::not_authorized.
If the server omits levels, comment, ip_address, time_left, or license_required, the library returns default values instead of std::optional, because it targets C++14 compatibility.
If the current account no longer has active license coverage, the operation returns blaze::status::app_user_has_no_valid_licenses.
On blaze::status::app_user_has_no_valid_licenses, some metadata such as login, levels, comment, ip_address, and license_required can still be useful, while time_left remains 0s.

Example

Compilation note

Synchronous and Asynchronous examples compile in the same form from C++14 to C++26.

#include "blazeauth/api/api.hpp"

#include <iostream>
#include <string>
#include <system_error>

void print_error_code(const std::string& context, const std::error_code& ec) {
  std::cout << context << ": " << ec.message() << " ("
            << ec.value() << " : " << ec.category().name() << ")\n";
}

std::string read_line(const std::string& label) {
  std::string value;
  std::cout << label << ": ";
  std::getline(std::cin, value);
  return value;
}

void print_status(const std::string& context, blaze::status status) {
  std::cout << context << ": "
            << static_cast<unsigned int>(status)
            << " (" << blaze::to_string(status) << ")\n";
}

int main() {
  const std::string websocket_api_key = read_line("Websocket API key");
  const std::string client_id = read_line("Client ID");
  const std::string login = read_line("Login");
  const std::string password = read_line("Password");

  blaze::session session;

  try {
    const blaze::api_server server = session.connect();
    std::cout << "Connected to server location: " << server.location << '\n';

    const blaze::application app = session.initialize(websocket_api_key, client_id);
    if (!app.good()) {
      print_status("Initialize returned status", app.status);
      return 1;
    }

    blaze::account_credentials credentials;
    credentials.login = login;
    credentials.password = password;
    credentials.type = blaze::credentials_type::login_password;

    const blaze::account auth_result = session.authorize(credentials);
    if (!auth_result.good()) {
      print_status("Authorize returned status", auth_result.status);
      return 1;
    }

    const blaze::account current_account = session.get_current_account();
    if (!current_account.good()) {
      print_status("Get-current-account returned status", current_account.status);
      return 1;
    }

    std::cout << "Current account login: " << current_account.login << '\n';
    std::cout << "Levels count: " << current_account.levels.size() << '\n';
    std::cout << "Time left: " << current_account.time_left.count() << "s\n";
    std::cout << "License required: " << (current_account.license_required ? "true" : "false") << '\n';

    session.shutdown();
  } catch (const std::system_error& e) {
    print_error_code("Get-current-account failed", e.code());
    return 1;
  }

  return 0;
}

#include "blazeauth/api/api.hpp"

#include <future>
#include <iostream>
#include <string>
#include <system_error>

void print_error_code(const std::string& context, const std::error_code& ec) {
  std::cout << context << ": " << ec.message() << " ("
            << ec.value() << " : " << ec.category().name() << ")\n";
}

std::string read_line(const std::string& label) {
  std::string value;
  std::cout << label << ": ";
  std::getline(std::cin, value);
  return value;
}

void print_status(const std::string& context, blaze::status status) {
  std::cout << context << ": "
            << static_cast<unsigned int>(status)
            << " (" << blaze::to_string(status) << ")\n";
}

int main() {
  const std::string websocket_api_key = read_line("Websocket API key");
  const std::string client_id = read_line("Client ID");
  const std::string login = read_line("Login");
  const std::string password = read_line("Password");

  blaze::session session;

  std::promise<int> completion;
  std::future<int> result = completion.get_future();

  session.async_connect(
    [&session, &completion, websocket_api_key, client_id, login, password](std::error_code connect_ec, blaze::api_server server) {
      if (connect_ec) {
        print_error_code("Connect failed", connect_ec);
        completion.set_value(1);
        return;
      }

      std::cout << "Connected to server location: " << server.location << '\n';

      session.async_initialize(websocket_api_key, client_id,
        [&session, &completion, login, password](std::error_code init_ec, blaze::application app) {
          if (init_ec) {
            print_error_code("Initialize failed", init_ec);
            completion.set_value(1);
            return;
          }

          if (!app.good()) {
            print_status("Initialize returned status", app.status);
            completion.set_value(1);
            return;
          }

          blaze::account_credentials credentials;
          credentials.login = login;
          credentials.password = password;
          credentials.type = blaze::credentials_type::login_password;

          session.async_authorize(credentials,
            [&session, &completion](std::error_code auth_ec, blaze::account auth_result) {
              if (auth_ec) {
                print_error_code("Authorize failed", auth_ec);
                completion.set_value(1);
                return;
              }

              if (!auth_result.good()) {
                print_status("Authorize returned status", auth_result.status);
                completion.set_value(1);
                return;
              }

              session.async_get_current_account(
                [&session, &completion](std::error_code current_ec, blaze::account current_account) {
                  if (current_ec) {
                    print_error_code("Get-current-account failed", current_ec);
                    completion.set_value(1);
                    return;
                  }

                  if (!current_account.good()) {
                    print_status("Get-current-account returned status", current_account.status);
                    completion.set_value(1);
                    return;
                  }

                  std::cout << "Current account login: " << current_account.login << '\n';
                  std::cout << "Levels count: " << current_account.levels.size() << '\n';
                  std::cout << "Time left: " << current_account.time_left.count() << "s\n";
                  std::cout << "License required: " << (current_account.license_required ? "true" : "false") << '\n';

                  session.async_shutdown([&completion](std::error_code shutdown_ec) {
                    if (shutdown_ec) {
                      print_error_code("Shutdown failed", shutdown_ec);
                      completion.set_value(1);
                      return;
                    }

                    completion.set_value(0);
                  });
                });
            });
        });
    });

  return result.get();
}

Project must be built with C++20 support and with coroutine support available both in the language mode and in the standard library implementation for this example to compile correctly.

#include "blazeauth/api/api.hpp"

#include <future>
#include <iostream>
#include <string>
#include <system_error>

void print_error_code(const std::string& context, const std::error_code& ec) {
  std::cout << context << ": " << ec.message() << " ("
            << ec.value() << " : " << ec.category().name() << ")\n";
}

std::string read_line(const std::string& label) {
  std::string value;
  std::cout << label << ": ";
  std::getline(std::cin, value);
  return value;
}

#if BLAZEAUTH_HAS_COROUTINES

blaze::coro::task<std::error_code> run_example(
  blaze::session& session,
  const std::string& websocket_api_key,
  const std::string& client_id,
  const std::string& login,
  const std::string& password
) {
  const auto [connect_ec, server] = co_await session.co_connect();
  if (connect_ec) {
    co_return connect_ec;
  }

  std::cout << "Connected to server location: " << server.location << '\n';

  const auto [init_ec, app] = co_await session.co_initialize(websocket_api_key, client_id);
  if (init_ec) {
    co_return init_ec;
  }

  if (!app.good()) {
    co_return blaze::make_error_code(app.status);
  }

  blaze::account_credentials credentials;
  credentials.login = login;
  credentials.password = password;
  credentials.type = blaze::credentials_type::login_password;

  const auto [auth_ec, auth_result] = co_await session.co_authorize(credentials);
  if (auth_ec) {
    co_return auth_ec;
  }

  if (!auth_result.good()) {
    co_return blaze::make_error_code(auth_result.status);
  }

  const auto [current_ec, current_account] = co_await session.co_get_current_account();
  if (current_ec) {
    co_return current_ec;
  }

  if (!current_account.good()) {
    co_return blaze::make_error_code(current_account.status);
  }

  std::cout << "Current account login: " << current_account.login << '\n';
  std::cout << "Levels count: " << current_account.levels.size() << '\n';
  std::cout << "Time left: " << current_account.time_left.count() << "s\n";
  std::cout << "License required: " << (current_account.license_required ? "true" : "false") << '\n';

  const auto [shutdown_ec] = co_await session.co_shutdown();
  co_return shutdown_ec;
}

int main() {
  const std::string websocket_api_key = read_line("Websocket API key");
  const std::string client_id = read_line("Client ID");
  const std::string login = read_line("Login");
  const std::string password = read_line("Password");

  blaze::session session;

  std::promise<std::error_code> completion;
  std::future<std::error_code> result = completion.get_future();

  blaze::coro::co_spawn([&session, &completion, websocket_api_key, client_id, login, password]() -> blaze::coro::task<void> {
    const std::error_code ec = co_await run_example(session, websocket_api_key, client_id, login, password);
    completion.set_value(ec);
    co_return;
  }());

  const std::error_code ec = result.get();
  if (ec) {
    print_error_code("Get-current-account failed", ec);
    return 1;
  }

  return 0;
}

#else

int main() {
  std::cout << "This example requires coroutine support in the Blazeauth library build.\n";
  return 0;
}

#endif

Get-current-account statuses

Value	Status	Returned when
`1`	`ok`	Current account data was returned successfully.
`3`	`not_authorized`	Session is not currently authorized by credentials.
`6`	`internal_server_error`	Server failed while resolving current account state.
`203`	`app_user_has_no_valid_licenses`	Current account no longer has active license coverage.

Connection-level shutdowns

Normal current-account results are returned in account.status. The websocket may still be closed by session-level guards:

Close code	Meaning	When it can happen
`4200`	`not_initialized`	`get_current_account` was called before a successful `initialize`.
`4201`	`rate_limited`	Session or IP rate limiting closed the websocket around this operation.

get_current_account

On this page