Skip to content

[인증문자]인증 문자 검증

노경민 edited this page Jan 17, 2022 · 3 revisions

POST

/auth/validation

Body Params

name type description Required
messageToken String 서버로 부터 받은 메세지 토큰 Required
authenticationNumber String 클라이언트가 전송할 인증번호 Required

Response

data : { userAccessToken }

userAccessToken

문자 인증에 성공할 경우 티켓을 구매할 수 있는 권한을 유저 엑세스 토큰으로 부여합니다

Name Type Description
userAccessToken String 유효기간 24시간의 엑세스 토큰입니다

성공시

{
    "success": true,
    "status": 200,
    "data": {
        "userAccessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwaG9uZU51bWJlciI6IjAxMDI4ODgzNDkyIiwiaWF0IjoxNjQyNDI2Mzg5LCJleHAiOjE2NDI1MTI3ODl9.4G12TUeLxQTXhSLqFzUvEjiznb-aPApDSZiu8tPC16o"
    }
}

실패시

1. 유효한 토큰이 아닐 경우

{
    "status": 401,
    "success": false,
    "message": "토큰 오류"
}

2. 3분이 지나 만료된 토큰을 사용할 경우

{
    "status": 401,
    "success": false,
    "message": "토큰 시간 만료"
}

3. 요청에 messageToken이 존재하지 않을 경우

{
    "status": 400,
    "success": false,
    "message": "검증오류",
    "data": [
        {
            "msg": "메세지 인증 토큰이 존재하지 않습니다.",
            "param": "messageToken",
            "location": "body"
        },
        {
            "value": "59289",
            "msg": "인증번호 길이는 6자여야 합니다.",
            "param": "authenticationNumber",
            "location": "body"
        }
    ]
}

4. 인증번호가 유효하지 않을 경우

msg description
인증번호가 존재하지 않습니다. 요청에 authenticationNumber가 없을 경우
숫자만 들어와야합니다. authenticationNumber에 숫자 이외의 문자가 포함될 경우
인증번호 길이는 6자여야 합니다. authenticationNumber의 길이가 6자리가 아닐 경우
{
    "status": 400,
    "success": false,
    "message": "검증오류",
    "data": [
        {
            "value": "59289",
            "msg": "인증번호 길이는 6자여야 합니다.",
            "param": "authenticationNumber",
            "location": "body"
        }
    ]
}