Skip to content

청기와랩 블로그

SMS API v1.0.1 업그레이드 공지 (2015.1.8)

2015년 01월 08일 by 청기와랩

기존 SMS API v1.0에 버그가 발견 되어 버그 픽스가 이루어 졌습니다.

v1.0의 버그 내용은 다음과 같습니다.
URI  /smscenter/v1.0/result/(Delivery-ID)   (개별 발송 결과 조회)
버그 내용 Response로 받는 JSON 데이타 중 status가 integer type이 아닌 string type으로 오는 경우 발생

정상 Behavior (최초 조회시)
{"status": 0, "destination": "01000000000", "sent_time": "2015-01-07T17:38:20Z"}

오류 Behavior (이후 재 조회시)
{"status": "0", "destination": "01000000000", "sent_time": "2015-01-07T17:38:20Z"}
문제점 값의 type이 일관되지 않음. 0 == "0" 인 특정 언어들 (PHP, Javascript 등) 에서는 문제가 없으나 대부분의 strict type checking을 하는 대부분의 언어로 해당 URI를 사용하는 경우, status 값에 비교 루틴 적용시 문제가 될 수 있음.
수정 상태 수정 및 서버 적용 완료
(자세한 내용은 아래 참조)

청기와랩의 이슈 수정을 위한 서버 변경 사항은 다음과 같습니다.
  • /smscenter/v1.0/result/(Delivery-ID) 은 현재 각 고객사 별로 운영중인 v1.0 Application들에 영향이 없도록 기존 behavior를 유지
    • 위의 오류 케이스가 발생 할 수 있음
    • 그러나 기존에 해당 URI를 사용하지 않거나 문제에 영향 없이 사용 하던 경우 별도의 수정 없이 그대로 계속 사용 가능
  • 2015. 1. 8일 부터 신규 발급되는 Application 들은 v1.0.1이 적용된 Application ID가 발급 되도록 함
  • v1.0.1 Application이 해당 URI 접근 시 수정된 정상 behavior 로 동작 함

F.A.Q
Q: 현재 v1.0 Application 을 구현하여 운영중인데 어떻게 해야 하나요?
A: 문제가 된 개별 발송 결과 조회 URI를 쓰고 있지 않았다면 기존 구현하신 프로그램 수정 없이 계속 사용 합니다.
만약 문제를 경험하신 경우 간단하게 v1.0.1 Application ID를 신규 발급 받아 적용 하시면 해결 됩니다.

Q: RESTful API의 URI들이 바뀐 버전 v1.0.1 에 맞추어 바뀌나요?
A: v1.0.1은 v1.0 프로토콜의 마이너 업데이트 이므로 기존 /smscenter/v1.0/XXX 형식의 URI 들은 계속 유지되고 기존 처럼 사용 가능 합니다. 

Q: GitHub의 예제들에 수정사항이 생기나요?
A: 아닙니다. 각 기능별 URI 가 바뀌지 않았으므로 코드 변경 없이 계속 사용 가능 합니다.


앞으로도 더욱 노력하는 청기와랩이 되겠습니다.
감사합니다



Contact us

청기와랩의 서비스