메시지의 흐름
발송하면 각 수신자는 대기열에 들어가고(queued) 요금이 차감된 뒤, 통신사 경로로 넘겨집니다(sent). 이후 통신사가 휴대폰에 도착했는지(delivered), 아닌지(failed)를 보고합니다.
보고가 도착하는 시점
대부분의 보고는 몇 초에서 몇 분 안에 도착합니다. 일부 통신사는 늦게 보고하거나 전혀 보고하지 않으며, 보고가 없는 메시지는 sent 상태로 남습니다.
환불
실패한 메시지는 자동으로 잔액에 환불됩니다. 잔액 내역에서 메시지 id와 함께 각 환불을 확인할 수 있습니다.
웹훅 받기
API 키 페이지에서 https 주소를 추가하세요. 메시지가 전송되거나 실패하면 메시지 id, 번호, 상태, 가격, ref가 담긴 JSON 본문을 POST합니다. 2xx 상태로 응답하세요. 그렇지 않으면 약 2시간 동안 최대 8번 다시 시도합니다.
서명 확인하기
모든 웹훅에는 X-PortSMS-Signature: t=<time>,v1=<hex>가 포함됩니다. 서명 비밀키로 t.body 문자열의 HMAC-SHA256을 계산해 v1과 비교하세요. 오래된 요청이 다시 사용되지 않도록 5분보다 오래된 요청은 거부하세요.
