[인증번호] sms 문자 발송 구현 - 쿨에스엠에스 (2024)

• 일경험 마지막 API 과제 중 하나였던 문자로 회원가입 인증번호 발송하기 
• 여러 문자메세지 발송 사이트중에 무료 300포인트를 주는 쿨에스엠에스를 선택함
• https://coolsms.co.kr/
• 구글링으로 찾은 코드들은 현재 쿨에스엠에스에서 올린 깃 코드와 약간의 차이가 있어서 쿨에스엠에스의 깃허브를 참고한 코드로 글을 작성함

 

쿨에스엠에스 회원가입 및 본인인증 하기

• 본인인증시 300포인트 무료 증정
• 카카오톡 알림도 가능하다고 함

쿨에스엠에스 대시보드

 

 

API Key와 API 비밀번호 확인하기

API Key

API Secret

 

 

 

대시보드 - 개발 탭에서 SDK 와 git repository 확인하기

SDK 와  git repository

        <dependency>
            <groupId>net.nurigo</groupId>
            <artifactId>sdk</artifactId>
            <version>4.3.0</version>
        </dependency>

 

 

 

스프링 코드

    private final DefaultMessageService messageService;


    /**
     * 단일 메시지 발송
     */
    @PostMapping("/sendSMS")
    @ResponseBody
    public ResponseEntity<?> sendSMS(@RequestParam("phoneNumber") String phoneNumber) {

        if (phoneNumber == null || phoneNumber.trim().isEmpty()) {
            // 전화번호가 제공되지 않았을 경우, 적절한 HTTP 응답 반환
            return ResponseEntity.badRequest().body("전화번호가 제공되지 않았습니다.");
        }

        Message message = new Message();

        String numStr = makeRandomNumStr();

        message.setFrom("01011111111"); //알맞게 수정하기
        message.setTo(phoneNumber); //사용자로부터 전달받은 전화번호(테스트는 개인번호로)
        message.setText("인증번호는 [" + numStr + "] 입니다.");

        //phoneNumber 와  numStr Repository에 저장하기
        confirmRepository.insertConfirmData(new ConfirmData("sms", phoneNumber, numStr));
        //이메일 인증번호도 같은 테이블을 사용하므로 type 명시
        

        // 메시지 발송 시도 및 응답 처리
        try {
            SingleMessageSentResponse response = this.messageService.sendOne(new SingleMessageSendingRequest(message));
            System.out.println(response);
            return ResponseEntity.ok(response); // 성공적으로 메시지를 보냈을 경우, 응답 반환
        } catch (Exception e) {
            // 메시지 발송 중 예외가 발생한 경우
            System.out.println(e.getMessage());
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("메시지 발송에 실패했습니다.");
        }
    }
    
    
    
        /**
     * 랜덤6자리 숫자String
     * */
    private String makeRandomNumStr(){
        Random rand = new Random();
        String numStr = "";
        for (int i = 0; i < 6; i++) {
            String ran = Integer.toString(rand.nextInt(10));
            numStr += ran;
        }
        return numStr;
    }

• 메세지 전송 관련 코드를 한 눈에 볼 수 있도록 컨트롤러에 모든 코드를 넣어서 글을 작성했음
• 관련 코드를 실제 사용할 경우 문자 내용 생성이나, 메세지 초기정보 세팅은 서비스 메서드로 빼기를 권장한다

 

 

 

전송 결과

콘솔.log

• 내 연락처의 부가적인 보안관련 설정으로 인해서 결과 확인은 못했음
• 인증관련 메세지를 입력받은 수신번호로 전송하려던 시도의 결과를 대시보드에서 확인할 수 있었다

메세지 전송 결과

• 보안 설정만 아니었으면 발송됐겠지만, 부가서비스를 변경할 마음은 없다
• 문자메세지 인증 기능 구현은 여기까지!