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
1	Email
3	APhoneNumber
4	Facebook
5	Google
6	Zalo
7	Guest
8	AppleId
10	Tele

Register with Google

Request

HTTP

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"
}

JavaScript

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.

OauthLink

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

HTTP

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"
}

JavaScript

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

HTTP

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]"
}

JavaScript

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

HTTP

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
}

JavaScript

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

HTTP

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
}

JavaScript

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

HTTP

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
}

JavaScript

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

First Tab

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
}

JavaScript

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

HTTP

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
}

JavaScript

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));