인증 (Authentication)

​

개요

​

Mutations

​

requestMileageSMSAuth

​

GraphQL Signature

mutation RequestMileageSMSAuth($phone: String!, $type: String) {
  requestMileageSMSAuth(phone: $phone, type: $type) {
    success
    _dev_sentAuth
  }
}

​

파라미터

​

응답

​

예제

mutation {
  requestMileageSMSAuth(
    phone: "01012345678"
    type: "reservation"
  ) {
    success
  }
}

{
  "data": {
    "requestMileageSMSAuth": {
      "success": true
    }
  }
}

​

Rate Limiting

• 제한: 10분 동안 동일 번호로 최대 5회
• 만료: 인증번호는 70초 후 만료

​

에러 처리

​

confirmMileageSMSAuth

​

GraphQL Signature

mutation ConfirmMileageSMSAuth($phone: String!, $number: String!) {
  confirmMileageSMSAuth(phone: $phone, number: $number)
}

​

파라미터

​

응답

​

예제

mutation {
  confirmMileageSMSAuth(
    phone: "01012345678"
    number: "123456"
  )
}

{
  "data": {
    "confirmMileageSMSAuth": "01HQKS9V8X2N3P4Q5R6S7T8U9V"
  }
}

​

Rate Limiting

• 제한: 1분 동안 동일 번호로 최대 10회
• 실패 시: 제한 초과 시 해당 번호의 인증번호가 삭제됩니다

​

에러 처리

​

사용 흐름

1. 인증번호 요청: requestMileageSMSAuth로 SMS 발송
2. 사용자 입력: 고객이 SMS로 받은 6자리 번호 입력
3. 인증 확인: confirmMileageSMSAuth로 검증 및 토큰 발급
4. 토큰 사용: 발급받은 authHash를 다른 API 요청에 사용

​

관련 API

• 마일리지 API - 인증 토큰을 사용한 마일리지 결제
• 예약 API - 인증 토큰을 사용한 예약 확인