Skip to content

[인증문자]인증 문자 전송 요청

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

POST

/auth/message

Body Params

name type description Required
phoneNumber String 전화번호(11자리) Required

Response

data : { messageToken }

messageToken

문자 전송에 성공하면 즉시 해당 전화번호와 인증번호가 토큰화되어 클라이언트에게 전송됩니다

Name Type Description
messageToken String 유효기간 3분의 문자 인증 토큰입니다

성공시

{
    "success": true,
    "status": 200,
    "data": {
        "messageToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJwaG9uZU51bWJlciI6IjAxMDI4ODgzNDkyIiwiYXV0aGVudGljYXRpb25OdW1iZXIiOiI5MDk5ODciLCJpYXQiOjE2NDI0MjU3NTEsImV4cCI6MTY0MjQyNTkzMX0.XQnGhAnFLHJDqpevgJzcV4RR1EmYBQKBxkK9J71KxKc"
    }
}

실패시

1. phoneNumber 오류

msg description
전화번호가 필요합니다. 요청에 phoneNumber가 없을 경우
숫자만 들어와야합니다. phoneNumber에 숫자 이외의 문자가 포함될 경우 ​
전화번호 길이는 11자이어야 합니다. phoneNumber의 길이가 11자리가 아닐 경우
{
    "status": 400,
    "success": false,
    "message": "검증오류",
    "data": [
        {
            "value": "0102883492",
            "msg": "전화번호 길이는 11자이어야 합니다.",
            "param": "phoneNumber",
            "location": "body"
        }
    ]
}

2. 네이버 SMS API 오류

status description
400 네이버 전송 실패
401(400) 네이버 인증키 오류 ​
403(400) 네이버 요청 거부
404(400) 네이버 전화번호 오류
429(400) 네이버 요청 초과
  • 편의상 400으로 status 고정하기로 했습니다
{
    "status": 400,
    "success": false,
    "message": "네이버 인증키 오류"
}

Clone this wiki locally