Authentication API

This document explains how to use Authentication APIs. Authentication APIs use HTTP POST protocol and send and receive messages in JSON format.

Endpoint

Real Server : https://auth.lmtls.io/v2

Test Server : https://test-auth.lmtls.io/v2

API References

Authenticate

Log in using your ID and password.

Authenticate with ID and password

POST/auth/auth-user

Body

application/json

userTypestring

User type (store, employee, platform, customer, root)

idstring

User ID

passwordstring

User password

tokenstring

JWT

Response

200400404

Returns a JWT (JSON Web Token) for authentication

Body

application/json

tokenstring

JWT (JSON Web Token)

userIdstring

namestring

telNostring

emailstring

Request

JavaScriptCurlPython

const response = await fetch('/auth/auth-user', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400404

{
  "token": "text",
  "userId": "text",
  "name": "text",
  "telNo": "text",
  "email": "text"
}

• userType is ignored. Currently it is not used.

• You can authenticate through id and password.

• If there is a token value, the token validity period can be extended.

• If successful, you get a new JWT token. It also receives basic user information, such as user name, userId, telNo, and email.

Example

Request

curl -X 'POST' \
  'https://test-auth.lmtls.io/v2/auth/auth-user' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "hong",
  "password": "1111"
}'

Response

{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0Iiwicm9sZSI6IlJPTEVfVVNFUiIsImV4cCI6MTY2ODc3ODEwMCwidXNlciI6IjQ3MDA2MDM2NDRCNzAwMDQiLCJpYXQiOjE2NjYxODYxMDB9.QQ_J1KMG58wG5D4THOCoXHqQVNd2SQ8j...",
  "userId": "hong",
  "name": "Hong kil dong",
  "telNo": "010-1111-2222",
  "email": "[e-mail]"
}