API

/

Auth

Auth

This document is a guide outlining the authentication procedures required for integrating with the Mori API.

You can obtain an access token through the login process and use it as credentials for subsequent API requests.

Account Authentication Flow

The diagram below illustrates the authentication process that clients must follow to access the Mori API.

Once login is complete, you can optionally register a webhook endpoint if needed.

Steps

Description

Notes

login(credentials)

Call the login API to obtain an access token.

The default validity period of the token is 2 hours.

createWebhookEndpoint
(accessToken, url)

로그인 API를 호출하여 액세스 토큰을 발급받아요.

This is optional and can be set if you want to receive event notifications.

Login API

This API is used to log in with the client’s account information and obtain an access token.

This token must be included in the Authorization header for most subsequent API requests.

Request Body

Field

Type

Description

email

string

The email address of the client registered in Mori Biz

password

string

The password set during registration

Response Headers

Key

Description

accessToken

Authentication token to be used for subsequent API calls

Response

Field

Type

Description

user.id

int

Client Unique ID

user.email

string

Registered Email Address

user.apiKey

string

API Key to be used for API calls

user.migrationKey

string

Key used for migration purposes

contract.planType

string

Current Subscription Plan

contract.planStartDate

string

Subscription Start Date

contract.planEndDate

string (nullable)

Subscription End Date (null if on the free plan)

contract.currentUsage

int

Current Usage

contract.usageLimit

int

Usage Limit

API

/

Auth

Auth

This document is a guide outlining the authentication procedures required for integrating with the Mori API.

You can obtain an access token through the login process and use it as credentials for subsequent API requests.

Account Authentication Flow

The diagram below illustrates the authentication process that clients must follow to access the Mori API.

Once login is complete, you can optionally register a webhook endpoint if needed.

Steps

Description

Notes

login(credentials)

Call the login API to obtain an access token.

The default validity period of the token is 2 hours.

createWebhookEndpoint
(accessToken, url)

로그인 API를 호출하여 액세스 토큰을 발급받아요.

This is optional and can be set if you want to receive event notifications.

Login API

This API is used to log in with the client’s account information and obtain an access token.

This token must be included in the Authorization header for most subsequent API requests.

Request Body

Field

Type

Description

email

string

The email address of the client registered in Mori Biz

password

string

The password set during registration

Response Headers

Key

Description

accessToken

Authentication token to be used for subsequent API calls

Response

Field

Type

Description

user.id

int

Client Unique ID

user.email

string

Registered Email Address

user.apiKey

string

API Key to be used for API calls

user.migrationKey

string

Key used for migration purposes

contract.planType

string

Current Subscription Plan

contract.planStartDate

string

Subscription Start Date

contract.planEndDate

string (nullable)

Subscription End Date (null if on the free plan)

contract.currentUsage

int

Current Usage

contract.usageLimit

int

Usage Limit