Register

Mimiland and games developed on the Mimiland platform always require a single account. Mimiland allows the use of third-party authentication for accounts

The AuthenType is used to indicate the type of authentication being used. Each different authentication method will be assigned corresponding values.

AuthenType

Method

APhoneNumber

Facebook

Google

Zalo

Guest

AppleId

Tele

Register with Google

Request

POST /v1/auth/register HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
Content-Length: 82

{
	 "AuthenType":5,
	 "AllowPubSub":false,
         "Redirect":"mmlcity://authcallback"
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");

const raw = JSON.stringify({
  "AuthenType": 5,
  "AllowPubSub": false,
  "Redirect": "mmlcity://authcallback"
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/register", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Parameter

Key

Required

Type

Description

AuthenType *required

True

Int

The AuthenType used to indicate the type of authentication being used.

Redirect *required

True

String

A body parameter is used to specify the redirect URL after authentication.

Upon Google registration, users will be redirected to a third-party platform for account authentication.

After a user successfully logs in with a third-party account, the app will be notified via a callback to verify if the account is new or already associated with another user.

Callback For App Check

Request

PUT /v1/oauth/app_gg_callback HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
shard: 1
Content-Length: 1138

{
          "state":"v4.local.9r7jN*****FtTvcdkd6yGJ",
          "oAuthID":"1",
          "email":"[email protected]",
          "token":"eyJraWQ*****kxpqvVfz_w",
          "data":"mydata"
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "state": "v4.local.9r7jN*****FtTvcdkd6yGJ",
  "oAuthID": "1",
  "email": "[email protected]",
  "token": "eyJraWQ*****kxpqvVfz_w",
  "data": "mydata"
});

const requestOptions = {
  method: "PUT",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/oauth/app_gg_callback", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Parameter

Key

Required

Type

Description

state *required

True

Int

The current state of the application.

oAuthID *required

True

String

The OAuth ID is associated with the user's account.

email *required

True

String

Email user.

token *required

True

String

A security token used for authentication purposes.

data Optional

Optional

String

Additional data to be included in the request.

Register With Email

Request

POST /v1/auth/register HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
shard: 1
Content-Length: 77

{
	"AuthenType":1,
	"Email":"[email protected]"
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "AuthenType": 1,
  "Email": "[email protected]",
  "ByPassCode": false
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/register", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Parameter

Key

Required

Type

Description

AuthenType *required

True

Int

The AuthenType used to indicate the type of authentication being used.

Email *required

True

String

Email is register

Once you've provided your email for registration, the system will initiate an API call to request a verification code.

Require Auth Code

Request

POST /v1/auth/code HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
shard: 1
Content-Length: 65

{
         "Email":"[email protected]",
         "AuthCodeTTL":true
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "Email": "[email protected]",
  "AuthCodeTTL": true
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/code", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

The user will then input the verification code sent to their email to confirm their identity.

Parameter

Key

Type

Description

AuthCodeTTL

Boolean

The duration in seconds for which the authentication code will be valid.

Email *required

String

Email is register

Verify Auth Code

Request

POST /v1/auth/codeconfirm HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: xapp
shard: 1
Content-Length: 86

{
	"Code":"229811",
	"UserID": "64daee9b5125b0c32fb01fa5",
        "IsRotateToken": true
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "xapp");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "Code": "229811",
  "UserID": "64daee9b5125b0c32fb01fa5",
  "IsRotateToken": true
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/codeconfirm", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

The code above is obtained from the email that the user receives upon registration.

Parameter

Field

Required

Type

Description

Code *required

True

String

The Code parameter is a body parameter used for passing the authentication code for verification.

UserID *required

True

String

The UserID parameter is a body parameter used for providing the user ID for the authentication code confirmation process.

Register With Apple ID

Request

POST /v1/auth/register HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
shard: 1
Content-Length: 41

{
	"AuthenType":8,
	"AllowPubSub":false
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "AuthenType": 8,
  "AllowPubSub": false
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/register", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Parameter

Feild

Type

Description

AuthenType *required

Int

The AuthenType used to indicate the type of authentication being used.

Additionally, Mimiland offers a guest mode that allows users to try out its features without needing third-party account authentication.

Callback For App Check

PUT /v1/oauth/app_apple_callback HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: mml
shard: 1
Content-Length: 1012

{
    "state":"v4.local.9r7jNVhPgYM8*****vcdkd6yGJ",
    "appleID":"76",
    "token":"v4.local.9r7jNV******FtTvcdkd6yGJ",
    "data":"11",
    "IsRotateToken": true
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "mml");
myHeaders.append("shard", "1");

const raw = JSON.stringify({
  "state": "v4.local.9r7jNV******vcdkd6yGJ",
  "appleID": "76",
  "token": "v4.local.9r7jNVhPgY******d6yGJ",
  "data": "11",
  "IsRotateToken": true
});

const requestOptions = {
  method: "PUT",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/oauth/app_apple_callback", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

Register As Guest

Request

POST /v1/auth/register HTTP/1.1
Host: dev.api.mimiland.io
Content-Type: application/json
mm-client-id: day
Content-Length: 45

{
	"AuthenType":7,
        "IsRotateToken":true
}

const myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("mm-client-id", "day");

const raw = JSON.stringify({
  "AuthenType": 7,
  "IsRotateToken": true
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

fetch("https://dev.api.mimiland.io/v1/auth/register", requestOptions)
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

PreviousApi References NextLogin

Last updated 1 year ago

hashtagRegister with Google

hashtagCallback For App Check

hashtagRegister With Email

hashtagRequire Auth Code

hashtagVerify Auth Code

hashtagRegister With Apple ID

hashtagCallback For App Check

hashtagRegister As Guest

Register with Google

Callback For App Check

Register With Email

Require Auth Code

Verify Auth Code

Register With Apple ID

Callback For App Check

Register As Guest