자바 Coolsms Message v4 연동 방법

Coolsms Message v4 (새로운 쿨에스엠에스) 버전 연동 방법입니다.

레거시 서비스 보다 금액도 저렴해지고, 속도 또한 빨라졌다고합니다.

한가지 주의 할 점은 해외 결제되는 카드가 있어야만 된다고하네요.

 

그리고 예전에는 서비스 센터가 운영이되서 전화로 문의하면 친절히 안내해줬던 것 같은데,

이번에 바뀌고 나서는 가이드 문서도 별로없고, 서비스 센터 전화 번호도 안보이네요 ㅠㅠ

 

일단 서비스 자체는 좋으니 아래 참고해서 연동하시길 바랍니다.

 

Message v4는 javascript(node.js), python, java, php, ruby에 대해 지원합니다.

저는 자바 쪽 연동을 했습니다.

 

아래 순서로 연동 진행해주세요.

예제 다운로드 주소는 https://github.com/coolsms/coolsms-v4-examples/tree/master/ 입니다.

 

1. lib 추가 (/WEB-INF/lib)

   - 라이브러리 추가 후에는 build and path 확인해주세요.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

2. java 소스 추가

  - 자바소스는 원하는 패키지 경로에 추가해주시고 예시 파일을 받으신 후 자바 소스 제일 상단에 패키지명을 추가 또는

    수정해주어야 합니다.

    예제파일에는 소스가 많이 올라가있는데 실제 필요한 파일은

    model.request.*    model.response.*     

    APIInit.java     CoolsmsImgApi.java     CoolsmsMsgV4.java     config.ini   

    입니다.

    SendMessage.java와 SendMessageLMS.java는 테스트용이고,

    테스트 용 파일을 기반으로 저는 SmsUtil.java를 만들어서 사용하였습니다.

 

 

 

3. 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3. config.ini 수정

   - coolsms 관리자 콘솔에서 API Key 관리에 들어가서 API Key, API secret을 확인한 뒤 입력해줍니다.

 

4. 기타 소스 수정 (자바 버전에 따라 다름)

  - APIInit.java 파일에 자바 버전에 따라 지원안되는 함수들이 있어서 수정해줍니다. 

    InvalidKeyException | NoSuchAlgorithmException | IOException e     

     -> Exception e

    String date = ZonedDateTime.now(ZoneId.of("Asia/Seoul")).toString().split("\\[")[0];

    -> SimpleDateFormat dayTime = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSXXX");
        String date = dayTime.format(new Date(System.currentTimeMillis()));

  -  SendMessage.java 등의 예제 파일도 수정해줍니다.

     api.enqueue(new Callback() {

    ->  api.enqueue(new Callback(<MessageModel>) {

 

여기서 잊으면 안될게 coolsms 관리자 콘솔 > 발신번호관리 화면에서 발신번호를 꼭 등록해줍니다!

 

그렇게 하고 테스트하면은 정상적으로 될 거에요.

서비스 센터를 운영하면 좋을텐데... 1:1 문의 답변도 느리다는것 같고,

조금 아쉽긴하네요.

 

예제 링크 등 상세한 내용은 아래 주소 참고해주세요.

https://support.coolsms.co.kr/hc/ko/articles/115000967152-%EA%B0%9C%EB%B0%9C%EC%9E%90-%EC%B0%B8%EA%B3%A0-%EB%AC%B8%EC%84%9C

개발자 참고 문서

https://docs.coolsms.co.kr/rest-api-reference/message-api-v4

Message API v4