핵심 정보
- 번호 1개 최저가
- $0.0018
- 인증
- API 키
- 형식
- JSON (HTTPS)
- 요청 한도
- 1분에 120번
- 환불
- 웹사이트와 같아요
REST와 JSON
요청 6가지로 잔액, 서비스, 가격, 번호 받기, 상태, 취소를 해요.
계정에서 만드는 키
내 계정의 API 키 화면에서 키를 만들고 Authorization 헤더에 넣어요.
웹사이트와 같은 가격
번호 가격과 20분 환불 규칙이 웹사이트와 같아요.
어떤 요청을 보낼 수 있나요?
기본 주소 뒤에 붙이는 경로예요. 모든 요청에 API 키가 필요해요.
| 메서드와 경로 | 하는 일 |
|---|---|
GET/ | 달러 잔액 |
GET/ | 모든 서비스와 서비스마다 최저가, 나라 수 |
GET/ | 한 서비스의 나라별 번호 1개 가격 |
POST/ | 서비스와 나라로 번호 받기, 가격은 잔액에서 빠져요 |
GET/ | 번호 상태와 지금까지 받은 코드 전부 |
POST/ | 코드가 오기 전에 취소, 가격은 잔액으로 돌아와요 |
API는 어떤 순서로 호출하나요?
- 1
번호 받기 service와 country로 POST /numbers를 보내요. id와 번호를 저장해요.
- 2
번호 넣기 코드를 보내는 서비스에 번호를 넣어요.
- 3
코드 확인 codes 목록이 비어 있지 않을 때까지 5초마다 GET /numbers/{id} 요청을 보내요.
- 4
마무리 코드를 써요. 코드가 오기 전에 번호가 필요 없어지면 취소해요.
API 키는 어떻게 받나요?
로그인하고 내 계정의 API 키 화면을 열어요. 키를 만들면 바로 복사해 두세요. 키는 한 번만 보여요. 새 키를 만들면 예전 키는 더 이상 쓸 수 없어요.
API 키기본 주소는 무엇인가요?
모든 요청은 이 주소로 보내고, 키는 Authorization 헤더(Bearer 키)나 X-Api-Key 헤더에 넣어요.
https://tomnumber.com/api/v1Authorization: Bearer <API_KEY>요청 항목
| 항목 | 쓰는 곳 | 값 |
|---|---|---|
service | POST /numbers, GET /prices | /services의 서비스 이름, 예: telegram |
country | POST /numbers | 영어 두 글자 나라 코드, 예: gb |
응답 항목과 상태
| 값 | 뜻 |
|---|---|
waiting | 번호가 열려 있고 아직 코드가 오지 않았어요 |
received | 코드가 하나 이상 왔어요. expires_at까지 더 올 수 있어요 |
refunded | 20분 안에 코드가 없어서 가격이 잔액으로 돌아갔어요 |
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" } ]}오류 코드
unauthorized | API 키가 없거나 틀렸어요 |
rate_limited | 1분에 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"const api = (path, init = {}) => fetch("https://tomnumber.com/api/v1" + path, { ...init, headers: { Authorization: "Bearer " + process.env.API_KEY, "Content-Type": "application/json" }, }).then((r) => r.json()); const n = await api("/numbers", { method: "POST", body: JSON.stringify({ service: "telegram", country: "gb" }) });console.log(n.number); // enter this number in the app let codes = [];while (!codes.length) { await new Promise((r) => setTimeout(r, 5000)); const s = await api("/numbers/" + n.id); if (s.status === "refunded" || s.status === "canceled") break; codes = s.codes;}console.log(codes.map((c) => c.code));import os, time, requests API = "https://tomnumber.com/api/v1"H = {"Authorization": "Bearer " + os.environ["API_KEY"]} n = requests.post(API + "/numbers", json={"service": "telegram", "country": "gb"}, headers=H).json()print(n["number"]) # enter this number in the app while True: time.sleep(5) s = requests.get(API + "/numbers/" + n["id"], headers=H).json() if s["codes"] or s["status"] in ("refunded", "canceled"): breakprint([c["code"] for c in s["codes"]])SMS 인증 API 자주 묻는 질문
SMS 인증 API는 무엇인가요?
웹사이트 대신 내 프로그램에서 번호를 사고 코드를 읽는 방법이에요.
API 요금은 따로 있나요?
없어요. 번호 가격은 웹사이트와 같고 같은 잔액에서 빠져요.
요청은 몇 번까지 보낼 수 있나요?
키마다 1분에 120번까지예요. 5초마다 확인해도 한도 안에 넉넉히 들어와요.
API로 산 번호도 환불되나요?
네. 20분 안에 코드가 없으면 가격이 잔액으로 돌아오는 규칙이 같아요.
API 키는 어디서 만드나요?
내 계정의 API 키 화면에서 만들어요.