청기와랩 블로그
Simple ! Simple ! Simple !
2014년 09월 29일 by 청기와랩
Simple is Best.
그렇습니다. 청기와랩의 SMS API는 정말 심플 합니다.
일단 복잡한 무언가가 들어가 있는 설계라면 그것은 최선의 디자인은 아닌거라고 봐도 됩니다. 그렇게 해야 할 수 밖에 없었던 엔지니어의 구구절절하고 눈물나는 사연이 있기 마련이죠.
그런데 청기와랩의 SMS API는 이런 저런 사연이 없습니다. 그냥 표준 !!!
다른 여타 OpenAPI들 보면 무슨 사연인지는 모르겠지만 X- 로 시작하는 Prefix 가 들어가는 확장 헤더를 쓴다거나 기타 Custom header 를 추가해야 하는 경우를 볼 수 있는데요. 그렇게 하면 아무래도 HTTP Client 구현이 까다롭고 자연스럽지 않을 수 밖에 없잖아요? 청기와랩의 SMS API는 그런거 없습니다. :-)
또 가장 궁금해 하실 만한 부분은 아무래도 보안 일텐데요. 이것도 그냥 표준 !!!
모두 웹 표준이고, 이것만으로 충분히 안전한 API 사용이 가능합니다.
단, 보안은 아무리 강조해도 지나치지 않다는것... 아시죠?
청기와랩의 API 서버가 아무리 표준 스펙의 보안 모델을 제공한다고 한들, SMS API를 이용하여 Client 를 구현할때 최소한의 안전 수칙도 지키고 있지 않은 채 구현되고 있다면... 보안 위험도가 증가할 수 있습니다.
안전 수칙은 정말 간단합니다. HTTPS 연결시 Certificate Verification 의 과정을 꼭 잊지 마세요!
마지막으로 API 디자인...
HTTP POST, GET, PUT, DELETE 과 같은 메소드로 정해진 URI 에 접근하는 방식으로 RESTful 한 디자인으로 작성 되어 있습니다.
군더더기 없이 Simple 하고 사용하기도 매우 쉽죠.
어때요? 청기와랩의 SMS API
심플하고 표준에 입각한 진정한 RESTful API 라는게 팍팍 느껴지시나요?
자! 바로 시작해 보세요.
API 문서는 http://bluehouselab-sms-openapi.readthedocs.org/ 에서..
예제 코드는 https://github.com/BlueHouseLab/sms-openapi
그런데 수퍼 개발자 시라면...
그런거 안봐도 바로 터미널 열고
$ git clone https://github.com/BlueHouseLab/sms-openapi.git
May the code be with you...
그렇습니다. 청기와랩의 SMS API는 정말 심플 합니다.
일단 복잡한 무언가가 들어가 있는 설계라면 그것은 최선의 디자인은 아닌거라고 봐도 됩니다. 그렇게 해야 할 수 밖에 없었던 엔지니어의 구구절절하고 눈물나는 사연이 있기 마련이죠.
그런데 청기와랩의 SMS API는 이런 저런 사연이 없습니다. 그냥 표준 !!!
- 통신프로토콜: HTTP
- 메시징포멧: JSON
다른 여타 OpenAPI들 보면 무슨 사연인지는 모르겠지만 X- 로 시작하는 Prefix 가 들어가는 확장 헤더를 쓴다거나 기타 Custom header 를 추가해야 하는 경우를 볼 수 있는데요. 그렇게 하면 아무래도 HTTP Client 구현이 까다롭고 자연스럽지 않을 수 밖에 없잖아요? 청기와랩의 SMS API는 그런거 없습니다. :-)
또 가장 궁금해 하실 만한 부분은 아무래도 보안 일텐데요. 이것도 그냥 표준 !!!
- 전송 보안은 TLS 1.x (HTTPS)
- API 인증은 RFC2617 (HTTP Basic Auth)
모두 웹 표준이고, 이것만으로 충분히 안전한 API 사용이 가능합니다.
단, 보안은 아무리 강조해도 지나치지 않다는것... 아시죠?
청기와랩의 API 서버가 아무리 표준 스펙의 보안 모델을 제공한다고 한들, SMS API를 이용하여 Client 를 구현할때 최소한의 안전 수칙도 지키고 있지 않은 채 구현되고 있다면... 보안 위험도가 증가할 수 있습니다.
안전 수칙은 정말 간단합니다. HTTPS 연결시 Certificate Verification 의 과정을 꼭 잊지 마세요!
마지막으로 API 디자인...
HTTP POST, GET, PUT, DELETE 과 같은 메소드로 정해진 URI 에 접근하는 방식으로 RESTful 한 디자인으로 작성 되어 있습니다.
군더더기 없이 Simple 하고 사용하기도 매우 쉽죠.
어때요? 청기와랩의 SMS API
심플하고 표준에 입각한 진정한 RESTful API 라는게 팍팍 느껴지시나요?
자! 바로 시작해 보세요.
API 문서는 http://bluehouselab-sms-openapi.readthedocs.org/ 에서..
예제 코드는 https://github.com/BlueHouseLab/sms-openapi
그런데 수퍼 개발자 시라면...
그런거 안봐도 바로 터미널 열고
$ git clone https://github.com/BlueHouseLab/sms-openapi.git
May the code be with you...
sms openapi HTTP TLS