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

Body

userTypestringOptional

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

idstringOptional

User ID

passwordstringOptional

User password

tokenstringOptional

JWT

Responses

200

Returns a JWT (JSON Web Token) for authentication

application/json

tokenstringOptional

JWT (JSON Web Token)

userIdstringOptional

namestringOptional

telNostringOptional

emailstringOptional

400

Missing parameters

application/json

404

User not found

application/json

post/auth/auth-user

POST /auth/auth-user HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 64

{
  "userType": "text",
  "id": "text",
  "password": "text",
  "token": "text"
}

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