Home

고스락 티켓 예매 프로젝트의 백엔드 api 명세관련 위키입니다.

host : https://api.gosrock.link

---

응답 컨벤션

{
    status : Number //(필수),
    success : Bool // (성공 여부 필수),
    message: String | null //( 실패시 오류 메시지), 
    data : Array | Object |[{express-validationError}]  | null  //(성공시 받는 데이타) , express-validationError Object 검증오류시 리턴
}

---

공통 오류

백엔드 api 전체에 걸친 응답 컨벤션입니다. 해당 내용을 숙지하시여 통신간에 참고하시길 바랍니다.

검증오류

express-validator에서 잘못된 요청을 거르는 오류 입니다. 검증에서 오류가난 경우 message 는 "검증오류" 입니다.

express-validatorError

name	type	description	Required
msg	String	오류 내용	Required
param	String	문제가 되는 파라미터	Required
location	String	body query 등 받는 부분	Required

• 에러 예시

{
   "status": 400,
    "success": false,
    "message": "검증오류",
    "data" : [
         {
            "msg": "숫자만 들어와야합니다.",
            "param": "phonenumber",
            "location": "body"
        },
        {
            "msg": "전화번호 길이는 11자이어야 합니다.",
            "param": "phonenumber",
            "location": "body"
        }
    ]
}

---

인증 오류

인증이 필요한 요청에 jsonWebToken 관련 오류 입니다.

토큰 시간 만료

토근 시간이 만료된 경우 (24시간 이상이 자났을때 나오는 오류입니다.)

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

토큰 인증 오류

토큰의 암호화 키값이나 손상된 토큰일때

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

---

서버 내부 오류 ( 핸들링 실패한 알수없는 오류 )

해당 오류가 클라이언트 단으로 리턴된다면 무조건 백엔드팀장한테 말씀해주시면 감사하겠습니다.

{
    "status": 500,
    "success": false,
    "message": "서버내부오류"
}

express-validatorError

name	type	description	Required
msg	String	오류 내용	Required
param	String	문제가 되는 파라미터	Required
location	String	body query 등 받는 부분	Required