본문으로 건너뛰기
tomnumber

SMS 인증 API

내 프로그램에서 번호를 사고 코드를 읽어요. API도 같은 잔액, 같은 가격, 같은 20분 환불 규칙을 써요.

API 키는 내 계정 안에서 만들어요. API로 받은 번호도 웹사이트와 같은 잔액에서 같은 가격으로 빠져요.

계정 만들기API 키

번호 1개 $0.0018부터

핵심 정보

번호 1개 최저가
$0.0018
인증
API 키
형식
JSON (HTTPS)
요청 한도
1분에 120번
환불
웹사이트와 같아요

REST와 JSON

요청 6가지로 잔액, 서비스, 가격, 번호 받기, 상태, 취소를 해요.

계정에서 만드는 키

내 계정의 API 키 화면에서 키를 만들고 Authorization 헤더에 넣어요.

웹사이트와 같은 가격

번호 가격과 20분 환불 규칙이 웹사이트와 같아요.

어떤 요청을 보낼 수 있나요?

기본 주소 뒤에 붙이는 경로예요. 모든 요청에 API 키가 필요해요.

어떤 요청을 보낼 수 있나요?
메서드와 경로하는 일
GET/balance달러 잔액
GET/services모든 서비스와 서비스마다 최저가, 나라 수
GET/prices?service=telegram한 서비스의 나라별 번호 1개 가격
POST/numbers서비스와 나라로 번호 받기, 가격은 잔액에서 빠져요
GET/numbers/{id}번호 상태와 지금까지 받은 코드 전부
POST/numbers/{id}/cancel코드가 오기 전에 취소, 가격은 잔액으로 돌아와요

API는 어떤 순서로 호출하나요?

  1. 1

    번호 받기 service와 country로 POST /numbers를 보내요. id와 번호를 저장해요.

  2. 2

    번호 넣기 코드를 보내는 서비스에 번호를 넣어요.

  3. 3

    코드 확인 codes 목록이 비어 있지 않을 때까지 5초마다 GET /numbers/{id} 요청을 보내요.

  4. 4

    마무리 코드를 써요. 코드가 오기 전에 번호가 필요 없어지면 취소해요.

API 키는 어떻게 받나요?

로그인하고 내 계정의 API 키 화면을 열어요. 키를 만들면 바로 복사해 두세요. 키는 한 번만 보여요. 새 키를 만들면 예전 키는 더 이상 쓸 수 없어요.

API 키

기본 주소는 무엇인가요?

모든 요청은 이 주소로 보내고, 키는 Authorization 헤더(Bearer 키)나 X-Api-Key 헤더에 넣어요.

https://tomnumber.com/api/v1
Authorization: Bearer <API_KEY>

요청 항목

요청 항목
항목쓰는 곳값
servicePOST /numbers, GET /prices/services의 서비스 이름, 예: telegram
countryPOST /numbers영어 두 글자 나라 코드, 예: gb

응답 항목과 상태

응답 항목과 상태
값뜻
waiting번호가 열려 있고 아직 코드가 오지 않았어요
received코드가 하나 이상 왔어요. expires_at까지 더 올 수 있어요
refunded20분 안에 코드가 없어서 가격이 잔액으로 돌아갔어요
canceled코드가 오기 전에 취소해서 가격이 잔액으로 돌아갔어요

응답 예시

{  "ok": true,  "id": "R8KQ2M7XWD4P",  "service": "telegram",  "country": "gb",  "number": "+44 7700 900412",  "price": "0.167",  "status": "received",  "expires_at": "2026-11-11T09:20:00.000Z",  "codes": [    { "code": "483920", "text": "Telegram code: 483920", "received_at": "2026-11-11T09:01:12.000Z" }  ]}

오류 코드

오류 코드
unauthorizedAPI 키가 없거나 틀렸어요
rate_limited1분에 120번을 넘었어요
bad_service없는 서비스 이름이에요
bad_country그 서비스에 없는 나라예요
low_balance잔액이 가격보다 적어요
unavailable지금 받을 수 있는 번호가 없어요. 잔액은 빠지지 않았어요
not_found내 계정에 그 id의 번호가 없어요
cannot_cancel코드가 이미 왔거나 번호가 닫혔어요

코드 예제

# get a numbercurl -X POST https://tomnumber.com/api/v1/numbers \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"service":"telegram","country":"gb"}' # check for codescurl https://tomnumber.com/api/v1/numbers/R8KQ2M7XWD4P \  -H "Authorization: Bearer $API_KEY"

SMS 인증 API 자주 묻는 질문

SMS 인증 API는 무엇인가요?

웹사이트 대신 내 프로그램에서 번호를 사고 코드를 읽는 방법이에요.

API 요금은 따로 있나요?

없어요. 번호 가격은 웹사이트와 같고 같은 잔액에서 빠져요.

요청은 몇 번까지 보낼 수 있나요?

키마다 1분에 120번까지예요. 5초마다 확인해도 한도 안에 넉넉히 들어와요.

API로 산 번호도 환불되나요?

네. 20분 안에 코드가 없으면 가격이 잔액으로 돌아오는 규칙이 같아요.

API 키는 어디서 만드나요?

내 계정의 API 키 화면에서 만들어요.

다른 서비스 가상번호