웹훅을 쓰는 이유
API를 계속 조회해도 되지만, 웹훅을 쓰면 코드가 반복해서 묻지 않아도 문자가 몇 초 안에 도착해요.
설정하기
API 키 페이지를 열고 공개 도메인의 HTTPS 주소를 입력한 뒤 저장하세요. 서명 비밀값은 한 번만 보여요. 서버의 다른 비밀값과 함께 보관하세요.
받는 내용
JSON 본문이 담긴 POST 요청이에요. 이벤트는 sms.received이고, data에는 대여 id, 전화번호, 발신자, 문자 전체 내용, 감지된 코드, 수신 시각이 들어 있어요.
모든 요청 확인하기
X-PortSMS-Signature 헤더를 읽고, 비밀값으로 "t.body"의 HMAC-SHA256을 계산해 v1과 상수 시간 비교로 맞춰 보세요. t가 5분보다 오래된 요청은 거부하세요.
빠르게 응답하기
문자를 저장하자마자 2xx 상태로 응답하고, 시간이 걸리는 작업은 그다음에 하세요. 다른 응답은 최대 8번까지 다시 보내요.