API

기간에 관계없이 모든 회선에 무료. 엔터프라이즈 요금제 없음, 사용자 수 기반 가격 없음, 영업 전화 없음.

기본 URL

https://api.hushsms.com

인증

회선 토큰을 Bearer 자격 증명으로 전달하세요. 토큰은 단일 회선에 범위가 지정되며 패널에서 교체할 수 있습니다.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

참조

엔드포인트

GET/v1/lines

토큰에 연결된 라인 목록을 조회합니다. 번호, 국가, 기간, 만료일을 반환합니다.

POST/v1/lines

라인을 프로비저닝합니다. 본문에 country, line_type, term, pool을 입력합니다. 암호화폐 인보이스를 반환합니다.

GET/v1/lines/{id}/messages

라인의 수신 메시지를 최신순으로 조회합니다. 본문은 보존 기간 후 삭제됩니다.

POST/v1/lines/{id}/messages

발신 SMS를 전송합니다. 모든 기간에 포함됩니다.

GET/v1/catalog

실시간 국가 재고, 서비스별 호환성, 현재 가격을 제공합니다. 인증이 필요 없습니다.

DELETE/v1/lines/{id}

라인을 조기 해제합니다. 월간 기간은 환불이 없으며, 6개월 이상은 비례 배분합니다.

푸시

웹훅

모든 인바운드 메시지는 도착 후 1초 이내에 HMAC-SHA256으로 서명되어 엔드포인트로 POST됩니다.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

기기

AI 에이전트용

기계 판독 가능한 카탈로그는 https://hushsms.com/v1/catalog/에 있습니다. 인증 없이 실시간 국가 재고, 서비스별 호환성, 현재 가격을 JSON으로 반환합니다.

Open the catalog

이 엔드포인트는 실시간 국가 재고, 작동하지 않는 서비스를 포함한 서비스별 호환성, 모든 배율이 적용된 현재 가격, 데이터 보존 테이블을 반환합니다. 키가 없고, 언급할 만한 속도 제한이 없으며, CORS가 열려 있습니다. 전화번호가 필요한 에이전트를 구축 중이라면 이 엔드포인트를 읽어야 합니다.

사이트 전체의 평문 요약은 /llms.txt에, 전체 코퍼스는 /llms-full.txt에 있습니다.

호출 가능한 계약으로서의 카탈로그

평문 코퍼스는 카탈로그를 읽을 수 있게 만듭니다. 하지만 호출 가능하게 만들지는 않습니다. 모든 내용을 읽은 에이전트도 요청 형식, 국가 슬러그의 열거형, 서버가 무시하는 필드를 알지 못하므로 구매할 수 없는 번호를 설명할 수 있습니다. 이 간극이 콘텐츠 중심 전략이 멈추는 지점입니다.

/openapi.json가 이 간극을 메웁니다. 공개된 인증 없는 세 엔드포인트(카탈로그 읽기, 주문 생성, 주문 폴링)를 다루는 OpenAPI 3.1 문서로, 국가, 기간, 풀 열거형은 핸들러가 검증하는 동일한 카탈로그에서 생성됩니다. 또한 문서 헤드에 rel="service-desc"로 선언되어, 서비스 설명을 찾는 클라이언트가 위치를 알려주지 않아도 찾을 수 있습니다.

OpenAPI 설명 열기

출처

이 페이지의 번호 계획 데이터 — 국가 번호, 국번 길이, 프리픽스, 이동 통신 범위 — 는 ITU-T E.164 시리즈에서 가져왔습니다. 재고, 가격, 측정된 성공률은 당사 고유 데이터이며 해당 표시가 있습니다.

ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Union국가별 국가 코드, 국번 없이 국가 내 유효 번호 길이, 번호 구조
ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Union국가별 번호 체계, 이동통신 번호 대역, 국번 접두사

번호 계획 검증일 2026년 8월 1일

번호 받기 문의