API
/
인증하기
인증하기
이 문서는 Mori API 연동을 위해 필요한 인증 절차를 안내하는 가이드예요.
로그인 과정을 통해 액세스 토큰을 발급받고, 이후 필요한 API 요청 시 이를 자격 증명으로 사용할 수 있어요.
계정 인증 흐름
아래 다이어그램은 고객사가 Mori API에 접근하기 위해 따라야 할 인증 과정을 보여줍니다.
로그인이 완료되면, 필요에 따라 웹훅 엔드포인트를 등록할 수도 있어요.
단계
설명
유의 사항
login(credentials)
로그인 API를 호출하여 액세스 토큰을 발급받아요.
토큰의 기본 유효 기간은 2시간이에요.
createWebhookEndpoint
(accessToken, url)
로그인 후 발급된 토큰을 사용해 웹훅 엔드포인트를 등록할 수 있어요.
관련 내용은 웹훅 등록하기 문서에서 확인할 수 있어요.
선택 사항이며, 이벤트 알림을 받고 싶을 때 설정하면 돼요.
로그인 API
이 API는 고객사의 계정 정보로 로그인하여 액세스 토큰을 발급받는 데 사용돼요.
이 토큰은 이후 대부분의 API 요청 시 Authorization 헤더에 포함되어야 해요.
POST
https://{{API_DOMAIN}}/api/v2/auth/login
요청 바디
필드
타입
설명
string
Mori Biz에 등록된 고객사의 이메일
password
string
등록 시 설정한 비밀번호
응답 헤더
키
설명
accessToken
이후 API 호출 시 사용할 인증 토큰
응답
필드
타입
설명
user.id
int
고객사의 고유 ID
user.email
string
등록된 이메일 주소
user.apiKey
string
API 호출 시 사용할 API 키
user.migrationKey
string
마이그레이션 용도로 사용되는 키
contract.planType
string
현재 사용 중인 요금제
contract.planStartDate
string
요금제 시작일
contract.planEndDate
string (nullable)
요금제 종료일 (무료 플랜일 경우 null)
contract.currentUsage
int
현재 사용량
contract.usageLimit
int
사용량 한도
API
/
인증하기
인증하기
이 문서는 Mori API 연동을 위해 필요한 인증 절차를 안내하는 가이드예요.
로그인 과정을 통해 액세스 토큰을 발급받고, 이후 필요한 API 요청 시 이를 자격 증명으로 사용할 수 있어요.
계정 인증 흐름
아래 다이어그램은 고객사가 Mori API에 접근하기 위해 따라야 할 인증 과정을 보여줍니다.
로그인이 완료되면, 필요에 따라 웹훅 엔드포인트를 등록할 수도 있어요.
단계
설명
유의 사항
login(credentials)
로그인 API를 호출하여 액세스 토큰을 발급받아요.
토큰의 기본 유효 기간은 2시간이에요.
createWebhookEndpoint
(accessToken, url)
로그인 후 발급된 토큰을 사용해 웹훅 엔드포인트를 등록할 수 있어요.
관련 내용은 웹훅 등록하기 문서에서 확인할 수 있어요.
선택 사항이며, 이벤트 알림을 받고 싶을 때 설정하면 돼요.
로그인 API
이 API는 고객사의 계정 정보로 로그인하여 액세스 토큰을 발급받는 데 사용돼요.
이 토큰은 이후 대부분의 API 요청 시 Authorization 헤더에 포함되어야 해요.
POST
https://{{API_DOMAIN}}/api/v2/auth/login
요청 바디
필드
타입
설명
string
Mori Biz에 등록된 고객사의 이메일
password
string
등록 시 설정한 비밀번호
응답 헤더
키
설명
accessToken
이후 API 호출 시 사용할 인증 토큰
응답
필드
타입
설명
user.id
int
고객사의 고유 ID
user.email
string
등록된 이메일 주소
user.apiKey
string
API 호출 시 사용할 API 키
user.migrationKey
string
마이그레이션 용도로 사용되는 키
contract.planType
string
현재 사용 중인 요금제
contract.planStartDate
string
요금제 시작일
contract.planEndDate
string (nullable)
요금제 종료일 (무료 플랜일 경우 null)
contract.currentUsage
int
현재 사용량
contract.usageLimit
int
사용량 한도
API
/
Auth
Auth
This document is a guide for the authentication procedures required to integrate with the Mori API.
You can obtain an access token through the login process, which can then be used 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.
After completing the login process, you may optionally register a webhook endpoint if needed.
Step
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)
After logging in, you can use the issued token to register a webhook endpoint.
For more details, see the Registering a Webhook document.
This step is optional and can be configured if you want to receive event notifications.
Login API
This API is used to log in with the client’s account credentials and obtain an access token.
This token must be included in the Authorization header for most subsequent API requests.
POST
https://{{API_DOMAIN}}/api/v2/auth/login
Request Body
Field
Type
Description
string
The customer’s email address registered with Mori Biz.
password
string
The password set during registration.
Response Header
Key
Description
accessToken
Authentication token to be used for subsequent API calls
Response
Field
Type
Description
user.id
int
The client’s unique ID
user.email
string
The registered email address
user.apiKey
string
The API key used for API calls
user.migrationKey
string
A key used for migration purposes
contract.planType
string
The subscription plan currently in use
contract.planStartDate
string
The start date of the subscription plan
contract.planEndDate
string (nullable)
The end date of the subscription plan (null for free plans)
contract.currentUsage
int
Current usage
contract.usageLimit
int
Usage limit
Getting Started
Integration Guide