터미널 crul 체험기

외부 api 연동하여 만들어야하는 기능 개발 중 항상 Test code로만 완성이 된 뒤 요청을 보내봤는데

이번에 터미널 crul을 통해 요청을 보내 정상적으로 작동되는지 확인해보았다.

 

nhn cloud service 중에 카카오 비즈니스 알림톡을 연동하여 관리하고 사용할 수 있게 해주는 api가 있다.

https://docs.toast.com/ko/Notification/KakaoTalk%20Bizmessage/ko/alimtalk-api-guide/#_2

API v2.2 가이드 - NHN Cloud 사용자 가이드

위의 링크로 들어가면 사용법이 나오는데 사용법 아래 예시로 curl이 써 있는 경우가 있다.

필수로 들어가야하는 값의 경우 {} 에 넣어주면 되는데

예를 들면 "X-Secret-Key:{secretkey}" 의 경우는 "X-Secret-Key:abcd" 이런 형태로 들어가게 된다.

 

참고로 Post 뒤에 -H는 헤더를 표현하고, -D는 데이터를 표현하는 값이다. 

curl -X POST -H "Content-Type: application/json;charset=UTF-8" -H "X-Secret-Key:{secretkey}" https://api-alimtalk.cloud.toast.com/alimtalk/v2.2/appkeys/{appkey}/messages -d '{"senderKey":"{발신 키}","templateCode":"{템플릿 코드}","requestDate":"2018-10-01 00:00","recipientList":[{"recipientNo":"{수신번호}","templateParameter":{"{치환자 필드}":"{치환 데이터}"}}]}'

 

위에 curl 코드는 예시를 복사해 붙여넣은 것인데 이것을 풀어보자면

Post 요청으로 보낼것이고, 헤더에는(H) 컨텐츠타입과 시크릿 키가 필요하다. 

요청을 보내야하는 url에는 괄호로 감싸여 있는 부분에 자신의 appKeys가 들어가야하고,

데이터(D) 에는 발신키와  템플릿 코드, 날짜 그리고 배열로 되어있는 치환 키와 키환 값이 필요하다. 라고 해석할 수 있다.

 

카카오 비즈니스 연동의 경우 계정 승인이 나지 않으면 채널 생성조차도 안되기 때문에 이러한 코드적인 부분 외의 

다른 요소로 인해 api가 동작이 잘 되는지 확인해보고 싶거나, 연동에 앞서 어떤 값이 필요한지 정리할 때 사용하면 좋은 듯 하다.