청기와랩 블로그
SMS API v1.0.2 마이너 업데이트 (2015.5.8)
2016년 10월 11일 by 청기와랩
SMS API v1.0과 v1.0.1에 마이너한 이슈가 발견 되어 픽스가 이루어 졌습니다.
기존 적용하신 v1.0 및 v1.0.1기반 프로그램의 경우 대부분 문제가 없으므로 수정 하실 필요 없으며, 향후 새로 생성되는 Application ID는 v1.0.2로 생성 됩니다.
v1.0.2에서 개선 내용은 다음과 같습니다.
청기와랩의 이슈 수정을 위한 서버 변경 사항은 다음과 같습니다.
F.A.Q
Q: 현재 v1.0 및 v1.0.1 Application 을 구현하여 운영중인데 어떻게 해야 하나요?
A: 해당 이슈가 문제 되지 않는 경우 구현하신 프로그램 수정 없이 계속 사용 합니다.
만약 문제를 경험하신 경우 간단하게 v1.0.2 Application ID를 신규 발급 받아 적용 하시면 됩니다.
Q: RESTful API의 URI들이 바뀐 버전 v1.0.2 에 맞추어 바뀌나요?
A: v1.0.2은 v1.0 프로토콜의 마이너 업데이트 이므로 기존 /smscenter/v1.0/XXX 형식의 URI 들은 계속 유지되고 기존 처럼 사용 가능 합니다.
Q: GitHub의 예제들에 수정사항이 생기나요?
A: 아닙니다. 각 기능별 URI 가 바뀌지 않았으므로 코드 변경 없이 계속 사용 가능 합니다.
앞으로도 더욱 노력하는 청기와랩이 되겠습니다.
감사합니다
기존 적용하신 v1.0 및 v1.0.1기반 프로그램의 경우 대부분 문제가 없으므로 수정 하실 필요 없으며, 향후 새로 생성되는 Application ID는 v1.0.2로 생성 됩니다.
v1.0.2에서 개선 내용은 다음과 같습니다.
URI |
/smscenter/v1.0/sendsms
(sms발송) |
버그 내용 |
receivers: ["", ] 처럼 수신자 목록 아이템은 있으나 유효성 체크 후에 [] 가 되어 수신자가 없는 경우에도 200 OK 가 리턴됨.
예) 200 OK {"filtered": [""], "reserved": null, "sent": []} # 200 OK지만 실제 발송내역이 없으므로 sent항목에 발송ID도 없음 |
문제점 |
수신자가 없어 발송ID가 생성되지 않으므로 CREDIT 차감 등의 문제는 없음
다만 리턴값이 200 OK 에서 412 같은 에러 값으로 바뀌어야 올바름 |
수정 상태 |
해당 경우 412 PRECONDITION FAILED 에러가 리턴 되도록 수정 및 서버 적용 완료
(자세한 내용은 아래 참조) 예) 412 PRECONDITION FAILED |
청기와랩의 이슈 수정을 위한 서버 변경 사항은 다음과 같습니다.
- 기존에 발급된 예전 버전의 App-ID 들은 기존 대로 동작됨
- 2015. 5. 8일 부터 신규 발급되는 Application 들은 v1.0.2이 적용된 Application ID가 발급 되도록 함
- v1.0.2 Application의 경우 수신자목록 (receivers)가 없는 경우 412 에러가 리턴되도록 동작 됨
F.A.Q
Q: 현재 v1.0 및 v1.0.1 Application 을 구현하여 운영중인데 어떻게 해야 하나요?
A: 해당 이슈가 문제 되지 않는 경우 구현하신 프로그램 수정 없이 계속 사용 합니다.
만약 문제를 경험하신 경우 간단하게 v1.0.2 Application ID를 신규 발급 받아 적용 하시면 됩니다.
Q: RESTful API의 URI들이 바뀐 버전 v1.0.2 에 맞추어 바뀌나요?
A: v1.0.2은 v1.0 프로토콜의 마이너 업데이트 이므로 기존 /smscenter/v1.0/XXX 형식의 URI 들은 계속 유지되고 기존 처럼 사용 가능 합니다.
Q: GitHub의 예제들에 수정사항이 생기나요?
A: 아닙니다. 각 기능별 URI 가 바뀌지 않았으므로 코드 변경 없이 계속 사용 가능 합니다.
앞으로도 더욱 노력하는 청기와랩이 되겠습니다.
감사합니다