Skip to content
This repository has been archived by the owner on Sep 21, 2022. It is now read-only.

User Authentication (C compatible)

Ahmed Castro edited this page Oct 21, 2019 · 7 revisions

modioEmailRequest

void modioEmailRequest(void* object, char* email, void (*callback)(void* object, ModioResponse response));

API endpoint used: Email Request

C++ wrapper: User Authentication#emailrequest

Requests a 5-digit security code to be sent via email. emailExchange should be called after to complete the authentication process.

Function parameters

Name Type Description
object void* Context parameter.
email char* User's email.
callback void (*callback)(void* object, ModioResponse response) Function called once the process finished.

Callback parameters

Name Type Description
object void* Context parameter.
response ModioResponse ModioResponse object that contains the mod.io response status.

Example

void onEmailRequest(void* object, ModioResponse response)
{
  if(response.code == 200)
  {
    //Email requested successfully
  }
}

[...]

modioEmailRequest(NULL,"example@mail.com",&onEmailRequest);

modioEmailExchange

void modioEmailExchange(void* object, char* security_code, void (*callback)(void* object, ModioResponse response));

API endpoint used: Email Exchange

C++ wrapper: User Authentication#emailexchange

Exchanges the 5-digit code for an authentication token. The token is handled internally by the SDK.

Function parameters

Name Type Description
object void* Context parameter.
security_code char* 5-digit code sent to users via email when emailRequest was called.
callback void (*callback)(void* object, ModioResponse response) Function called once the process finished.

Callback parameters

Name Type Description
response ModioResponse ModioResponse object that contains the mod.io response status

Example

void onExchange(void* object, ModioResponse response)
{
  if(response.code == 200)
  {
    //Code exchanged successfully
  }
}

[...]

modioEmailExchange(NULL, "5UI23", &onExchange);

modioAuthenticateViaToken

void modioAuthenticateViaToken(char const* access_token);

C++ wrapper: User Authentication#authenticateviatoken

Authenticates the user by providing a valid mod.io token directly.

Function parameters

Name Type Description
access_token char const* mod.io user authentication token.

Example

modioAuthenticateViaToken("eykger...lkw421");

modioIsLoggedIn

bool modioIsLoggedIn();

C++ wrapper: User Authentication#isloggedin

Returns true if the user is logged in, otherwise returns false.

modioGetCurrentUser

const struct ModioUser modioGetCurrentUser();

Returns a ModioUser object corresponding to the current user logged in.

Example

if(modioIsLoggedIn())
{
    printf("Logged in as %s\n", modioGetCurrentUser().username);
}else
{
  printf("You are not logged in.\n");    
}

modioLogout

void modioLogout();

C++ wrapper: User Authentication#logout

Logs out the user from mod.io.

Contents

Clone this wiki locally