개발자 가이드

개발자 문서

SMS Activate는 임시 전화번호를 대규모로 임대하려는 프로그래매틱 사용자를 위한 완전 자동화 API를 제공합니다.

Create an API key in your dashboard and send it in the X-API-KEY header to https://api.smsactivate.uk. Order a number with POST /get_numbers using a service code and numeric country ID, then poll GET /status/{order_id} for the code. This API receives codes on a number you order. It does not send codes to your own users.

시작하기

대시보드에서 API 키를 만든 다음 서버 측 요청에 사용하세요.

실제 API 키를 브라우저 코드, 스크린샷, 공개 저장소에 절대 넣지 마세요.

API 키 열기

What does a first integration look like, end to end?

Start with GET /balance. A failed first call usually means the key or header is wrong.

Check what is live before you order: GET /services for service codes, GET /countries/{service} for country IDs, GET /offers/{service}/{country} for current offers. Availability changes; the catalog here is a reference, not a promise of stock. Browse all services.

POST /get_numbers with service and country. The response gives you an order id and a phone number; save the id.

Poll GET /status/{order_id} until the status reads received, then read sms_code.

What happens to an order after you place it?

An order moves through states, and what you can do depends on the state.

Active means the number is waiting for an SMS. While active you can ask for another SMS with POST /resend/{order_id} on a supported activation, or cancel an eligible one with POST /cancel/{order_id}. Cancel only works 2 to 20 minutes after purchase, and only before an SMS arrives.

Received means the code arrived. An expired order ran out its 20-minute window with no SMS and returns its stored status. An eligible activation that receives no SMS is refunded to your wallet. Read the FAQ.

Check the cancel response before you retry anything. If a purchase response is uncertain, do not order again until its status is clear. Contact support.

What mistakes cost first-time integrators the most?

Putting the key in browser code or a public repo. Keep it on a server you control.

Ordering before checking availability. GET /offers/{service}/{country} first saves a failed order.

Polling without a stop. GET /sms/{order_id} is rate-limited, so use GET /status/{order_id} and stop at a final state: received, cancelled, expired or refunded.

Retrying a purchase that came back uncertain. A 503 can mean the order went through and the answer got lost. Contact support.

Reusing an idempotency key for a different purchase. Use the same key only to check the outcome of the same purchase request.

Assuming the code will be accepted. Acceptance is the receiving service's decision, not ours.

Buying a one-time activation for an account that will ask for a code again - rentals are for that: 24 to 1,344 hours on the same number.

1. 인증

계정 대시보드의 설정에서 API 키를 발급받으세요. 모든 API 요청에는 다음 헤더가 포함되어야 합니다:

X-API-KEY: your_api_key_here

2. 기본 URL

모든 API 요청은 이 기본 URL을 사용합니다:

https://api.smsactivate.uk

요청 예시

이 요청은 주문을 생성하며 지갑에서 요금이 청구될 수 있습니다. 예시 서비스와 국가를 내 계정에서 사용 가능한 선택으로 바꾸세요.

curl -X POST https://api.smsactivate.uk/get_numbers   -H "X-API-KEY: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"service":"tg","country":2}'

API 레퍼런스

각 작업에는 입력값, 요청 예시, 대표 응답, 주요 오류가 나와 있습니다. 기존 API 연동은 이전 엔드포인트를 계속 사용할 수 있으며, 신규 연동에는 아래의 상품 기반 엔드포인트를 권장합니다. 예시에는 임의의 ID와 값이 사용됩니다. 인증된 요청은 서버에서 API 키 헤더와 함께 보내세요.

시작하기

GET/balance지갑의 현재 잔액을 조회합니다.

API 키가 필요합니다.

매개변수

없음
쿼리 매개변수가 없습니다.

요청 예시

curl https://api.smsactivate.uk/balance -H "X-API-KEY: YOUR_API_KEY"

응답

{ "balance": "10.0000" }

Errors

이 엔드포인트는 인증된 계정의 현재 잔액을 반환합니다.

번호 받기 및 관리

POST/get_numbers활성화 주문을 생성합니다.

API 키가 필요합니다.

매개변수

service
필수 문자열. 서비스 코드, 예: tg.
country
필수 정수. 숫자 국가 ID.
operator
선택 문자열. 기본값은 any.
max_price
선택 숫자. 최대 가격. maxPrice도 사용할 수 있습니다.
min_price
선택 숫자. minPrice도 사용할 수 있습니다.
any_price
선택 불리언. anyPrice도 사용할 수 있습니다.
product
선택: standard(기본값) 또는 api_links. API Links는 환불 불가 재고 구매입니다.
idempotency_key
표준 활성화용 선택 UUID. 결과를 확인하는 중인 동일한 구매 요청에만 같은 키를 재사용하세요.
quantity
API Links 재고 주문용 1~100 사이의 선택 정수. 기본값은 1. 표준 활성화 주문은 번호 하나입니다.

요청 예시

curl -X POST https://api.smsactivate.uk/get_numbers \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"tg","country":2}'

응답

{
  "id": "ORDER_ID",
  "phone": "10000000000",
  "price": "0.2500",
  "balance_remaining": "9.7500"
}

Errors

HTTP 400: 선택 불가, 가격 한도 또는 잔액 부족. HTTP 409: 이전 주문을 아직 확인 중입니다. HTTP 503: 일시적 오류 또는 불확실한 주문. 응답에 조정이 필요하다고 표시되면 재시도하지 말고 지원팀에 문의하세요.

GET/sms/{order_id}활성 주문의 상태를 다시 확인하도록 요청합니다.

API 키가 필요합니다. 이 엔드포인트에는 요청 제한이 있습니다.

매개변수

order_id
주문 생성 시 반환된 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/sms/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "status": "received",
  "sms_code": "123456",
  "raw_sms": "Your verification code is 123456"
}

Errors

HTTP 400: 이 주문은 SMS 확인을 사용할 수 없습니다. HTTP 404: 주문을 찾을 수 없습니다. HTTP 502: 일시적 확인 실패. 만료된 주문은 새 외부 확인 없이 저장된 상태를 반환합니다.

GET/status/{order_id}주문 상태와 수신된 SMS를 조회합니다.

API 키가 필요합니다.

매개변수

order_id
주문 생성 시 반환된 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "status": "received",
  "sms_code": "123456",
  "raw_sms": "Your verification code is 123456"
}

Errors

응답은 인증된 계정의 주문으로 한정됩니다. 상태 조회가 실패하면 API가 오류를 반환합니다. 주문 ID를 확인하고 서비스가 일시적으로 사용 불가이면 나중에 다시 시도하세요.

POST/resend/{order_id}지원되는 활성 활성화에 대해 SMS를 한 번 더 요청합니다.

API 키가 필요합니다.

매개변수

order_id
필수 경로 값. 요청 본문 없음.

요청 예시

curl -X POST https://api.smsactivate.uk/resend/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

{ "message": "Resend request successful. Waiting for new SMS." }

Errors

HTTP 400: 재전송이 허용되지 않거나 주문이 만료되었습니다. HTTP 409: 이 주문은 재전송을 사용할 수 없습니다. HTTP 500: 재전송을 완료하지 못했습니다.

POST/cancel/{order_id}취소 가능한 활성화의 취소를 요청합니다.

API 키가 필요합니다.

매개변수

order_id
필수 경로 값. 요청 본문 없음.

요청 예시

curl -X POST https://api.smsactivate.uk/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "message": "Number cancelled and balance refunded",
  "refunded_amount": "0.2500",
  "new_balance": "10.0000"
}

Errors

취소는 구매 후 2~20분 사이이고 SMS가 도착하기 전의 취소 가능한 활성 활성화에만 가능합니다. 임대는 /rent/cancel/{order_id}를 사용하며 API Links는 환불 불가입니다. 취소 불가이거나 확인되지 않은 취소는 오류를 반환합니다. 재시도하기 전에 취소 응답을 확인하세요.

GET/reactivate/{order_id}/options현재 재활성화 가격과 세부 정보를 확인합니다.

API 키가 필요합니다.

매개변수

order_id
원래 주문의 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/reactivate/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "price": 0.25,
  "duration": 20,
  "phone": "10000000000",
  "service": "tg",
  "country": 2
}

Errors

HTTP 400: 재활성화가 지원되지 않거나 사용할 수 없습니다. HTTP 409: 이 주문은 재활성화를 사용할 수 없습니다. HTTP 503: 유효한 현재 가격을 확인하지 못했습니다.

POST/reactivate/{order_id}취소 가능한 활성화를 현재 가격으로 재활성화합니다.

API 키가 필요합니다.

매개변수

order_id
원래 주문의 필수 경로 값입니다. 요청 본문 없음.

요청 예시

curl -X POST https://api.smsactivate.uk/reactivate/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "message": "Number reactivated successfully.",
  "id": "NEW_ORDER_ID",
  "phone": "10000000000",
  "price": 0.25,
  "balance_remaining": 9.75
}

Errors

HTTP 400: 재활성화가 지원되지 않거나 지갑 잔액이 부족합니다. HTTP 409: 이 주문은 사용할 수 없습니다. HTTP 503: 결과를 확인하지 못했습니다. 다시 시도하기 전에 지원팀에 문의하세요.

GET/orders/{order_id}내 주문 중 하나의 세부 정보를 조회합니다.

API 키가 필요합니다.

매개변수

order_id
주문 생성 시 반환된 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/orders/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the order record with buyer-facing fields, including its status and remaining time where applicable. Internal routing IDs and cost fields are not returned.

Errors

HTTP 404: 주문을 찾을 수 없거나 내 계정의 주문이 아닙니다.

서비스, 국가, 가격 선택

서비스이름 또는 코드로 서비스 카탈로그를 검색하세요. 재고는 변동될 수 있으니 주문 전에 실시간 엔드포인트를 확인하세요.
이름 / 코드1,638 카탈로그 항목
  • 163COMwp
  • 11688hn
  • 11and1ahs
  • 11xbetwj
  • 224bettinglh
  • 22dehandsapd
  • 22domainserc
  • 22ememainblx
  • 22ГИСbcg
  • 332Redqi
  • 3360Krediayo
  • 33Funauw
  • 44FunLitehk
  • 5500pxfpx
  • 551exchboc
  • 551exchangeexc
  • 77-Elevenaws
  • 8888casinoll
  • 9999 Mdbrv
  • 99acresfw
  • 99appki
  • 999Gameqkb
  • 999k Outletamq
  • AA23acv
  • AA9Agn
  • AAadharhra
  • Abastece-aíanb
  • AAbbottags
  • Ace2Threerh
  • AAcimacim
  • AAckoamf
  • AdaKamiko
  • AAdaModalbdo
  • AAdanibq
  • AAdidasan
  • AAditya Birlaqff
  • AAdmiralBetbst
  • AAdobebyh
  • Advertsagw
  • AAEG Presentsrsn
  • AAffirmbow
  • AAfreecaTVaip
  • AGIBANKsa
  • AAgodaag
  • AgriDevelopcs
  • AAgroinformqu
  • AAhlanbsm
  • AAiqfomebbi
  • AAir Milesbsy
  • AAirba Freshbnp
  • Airbnbuk
  • AAirtaskerbyd
  • Airtelzl
  • AAirtimeacy
  • AISwv
  • AAIS PLAYaxs
  • Aitujj
  • Akudorf
  • Akulakutm
  • Alchemyaav
  • Alfabt
  • Alfagiftbn
  • AAlfamidibgt
  • AAlFursanbxr
  • AAlgidalp
  • AAlibabaab
  • AliExpresshx
  • AAlignableaul
  • Alipay/Alibaba/1688hw
  • All Accessajy
  • Allegroyn
  • AlloBanknh
  • AAllofreshaeo
  • AAltyn-ial
  • AAmap 高德地图btx
  • AAmarthaFinbsv
  • Amasiayo
  • AAmaze Super Appbzk
  • Amazonam
  • AAme Digitalafi
  • AAmwayaee
  • AAngel Oneaha
  • Ankamaalg
  • AAnnoncelightbyw
  • Any Otherot
  • AOLpm
  • ApostaGanhaml
  • Applewx
  • Apteka Aprelaeh
  • AptekaRUgk
  • AAptekiPlusrq
  • AAR Lensaco
  • ArenaPlusabt
  • AArgentamo
  • AAri10blq
  • AASAASbqr
  • AAsdahs
  • AAsiaMilesajp
  • AAsianDatingayb
  • AAskablebpi
  • AAspirationaptn
  • Astra Otoshopafd
  • AstraPayaem
  • Astropaygr
  • AASVLAbuj
  • AAti Subhl
  • AAtlas Earthawq
  • AAtlasbusatb
  • AttaPollanl
  • AAUBANKdu
  • Auchanst
  • AAudibleaud
  • AAukroaox
  • AAuthentifyccy
  • AAuthor24kd
  • AAutodeskbbl
  • Autoruaej
  • AAv100proajl
  • AAvitoav
  • AVONff

실시간 재고 및 응답 예시:

GET https://api.smsactivate.uk/services
{
  "services": ["tg", "wa", "go"],
  "providers": { "source-counts": "per active catalog" },
  "generated_at": "ISO 8601 timestamp"
}

카탈로그는 조회용 이름과 코드를 제공합니다. 재고는 실시간이며 이 목록과 다를 수 있습니다. 이 JSON은 응답 형태를 보여줄 뿐 현재 재고가 아닙니다.

국가대시보드 카탈로그의 숫자 국가 ID입니다. 표준 활성화용 일반 국가 목록 API 엔드포인트는 없습니다.
국가 / 숫자 ID206 카탈로그 항목
  • Afghanistan74
  • Albania155
  • Algeria58
  • Angola76
  • Anguilla181
  • Antigua and Barbuda169
  • Argentina39
  • Armenia148
  • Aruba179
  • Australia175
  • Austria50
  • Azerbaijan35
  • Bahamas122
  • Bahrain145
  • Bangladesh60
  • Barbados118
  • Belarus51
  • Belgium82
  • Belize124
  • Benin120
  • Bermuda195
  • Bhutan158
  • Bolivia92
  • Bosnia108
  • Botswana123
  • Brazil73
  • Brunei121
  • Bulgaria83
  • Burkina Faso152
  • Burundi119
  • Cambodia24
  • Cameroon41
  • Canada36
  • Cape Verde186
  • Cayman Islands170
  • Central African Republic125
  • Chad42
  • Chile151
  • China3
  • Colombia33
  • Comoros133
  • Congo150
  • Costa Rica93
  • Croatia45
  • Cuba113
  • Cyprus77
  • Czech63
  • Denmark172
  • Djibouti168
  • Dominica126
  • Dominican Republic109
  • DR Congo18
  • Ecuador105
  • Egypt21
  • Equatorial Guinea167
  • Eritrea176
  • Estonia34
  • Ethiopia71
  • Faroe Islands202
  • Fiji189
  • Finland163
  • France78
  • French Guiana162
  • Gabon154
  • Gambia28
  • Georgia128
  • Germany43
  • Ghana38
  • Gibraltar201
  • Greece129
  • Grenada127
  • Guadeloupe160
  • Guatemala94
  • Guinea68
  • Guinea-Bissau130
  • Guyana131
  • Haiti26
  • Honduras88
  • Hong Kong14
  • Hungary84
  • Iceland132
  • India22
  • Indonesia6
  • Iran57
  • Iraq47
  • Ireland23
  • Israel13
  • Italy86
  • Ivory Coast27
  • Jamaica103
  • Japan182
  • Jersey194
  • Jordan116
  • Kazakhstan2
  • Kenya8
  • Kosovo203
  • Kuwait100
  • Kyrgyzstan11
  • Laos25
  • Latvia49
  • Lebanon153
  • Lesotho136
  • Liberia135
  • Libya102
  • Liechtenstein200
  • Lithuania44
  • Luxembourg165
  • Macao20
  • Madagascar17
  • Malawi137
  • Malaysia7
  • Maldives159
  • Mali69
  • Malta199
  • Mauritania114
  • Mauritius157
  • Mexico54
  • Moldova85
  • Monaco144
  • Mongolia72

하나의 서비스와 국가에 대한 오퍼 응답 형태:

[
  { "name": "any", "offers": [{ "price": 0.25, "count": 4 }] }
]

카탈로그 ID는 국가 선택지를 식별할 뿐 실시간 오퍼를 보장하지 않습니다. 재고는 /offers/{service}/{country} 에서 확인하세요.

GET/services서비스의 현재 재고 상태를 확인합니다.

공개 - API 키가 필요하지 않습니다.

매개변수

없음
이 엔드포인트는 쿼리 매개변수를 받지 않습니다.

요청 예시

curl https://api.smsactivate.uk/services

응답

Returns the current services array and generated_at timestamp. See the searchable Services catalog below for code/name lookup; it is a maintained reference, not a live availability guarantee.

Errors

재고는 변동될 수 있습니다. 주문하기 전에 실시간 엔드포인트와 /offers/{service}/{country}를 확인하세요.

GET/countries/{service}서비스에 현재 번호가 있는 국가 ID 목록을 조회합니다.

공개 - API 키가 필요하지 않습니다.

매개변수

service
필수 서비스 코드, 예: tg.

요청 예시

curl https://api.smsactivate.uk/countries/tg

응답

{ "countries": [2, 6, 187] }

Errors

국가 ID는 아래 국가 카탈로그와 일치합니다. 재고는 변동됩니다. 주문하기 전에 /offers/{service}/{country}를 확인하세요. 이 엔드포인트에는 요청 제한이 있습니다.

GET/offers/{service}/{country}/delivery가격 구간별 최근 코드 수신율을 확인합니다.

공개 - API 키가 필요하지 않습니다.

매개변수

service
필수 서비스 코드, 예: tg.
country
필수 숫자 국가 ID.

요청 예시

curl https://api.smsactivate.uk/offers/tg/2/delivery

응답

{
  "window_days": 30,
  "tiers": { "0.2500": { "orders": 120, "codes": 108, "delivery_pct": 90, "best": true } }
}

Errors

HTTP 400: 잘못된 서비스 또는 국가. 수신된 코드가 없는 구간은 표시되지 않습니다. 결과는 약 5분간 캐시되며 최근 window_days일을 대상으로 합니다. 이 엔드포인트에는 요청 제한이 있습니다.

GET/operators?service={service}&country={country}서비스와 국가에 사용 가능한 통신사 목록을 조회합니다.

공개 - API 키가 필요하지 않습니다.

매개변수

service
필수 서비스 코드, 예: tg.
country
필수 숫자 국가 ID.

요청 예시

curl 'https://api.smsactivate.uk/operators?service=tg&country=2'

응답

[
  { "name": "any", "localName": "Any Operator" },
  { "name": "example", "localName": "Example operator" }
]

Errors

목록은 선택한 국가와 현재 재고에 따라 달라집니다. service와 country 모두 필수이며, 누락되거나 잘못된 값은 HTTP 422를 반환합니다.

GET/offers/{service}/{country}하나의 서비스와 국가 조합에 대한 오퍼를 확인합니다.

공개 - API 키가 필요하지 않습니다.

매개변수

service
필수 경로 값. /services가 반환한 서비스 코드를 사용하세요. 예: tg.
country
필수 경로 값. 숫자 국가 ID. 표준 활성화는 대시보드 국가 카탈로그를 사용하세요. 이 국가 ID를 나열하는 일반 API 엔드포인트는 없습니다.

요청 예시

curl https://api.smsactivate.uk/offers/tg/2

응답

[
  {
    "name": "any",
    "offers": [{ "price": "0.2500", "count": 4 }]
  }
]

Errors

지원되지 않거나 사용할 수 없는 조합은 빈 목록을 반환할 수 있습니다. 오퍼 데이터는 캐시되며, 캐시에 없으면 재고를 확인하는 동안 더 오래 걸릴 수 있습니다.

지난 활동 보기

GET/orders주문 내역을 최신순으로 조회합니다.

API 키가 필요합니다.

매개변수

page
선택 페이지 번호. 기본값은 1.
per_page
선택 페이지 크기. 기본값은 20이며 최대 100입니다.
status
선택: active, completed(또는 received), cancelled, expired, refunded. 모든 상태를 포함하려면 생략하거나 all을 사용하세요.
search
선택 전화번호 검색.
category
선택: rents, links 또는 numbers.

요청 예시

curl 'https://api.smsactivate.uk/orders?page=2&per_page=100&status=received&category=numbers' -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "current_page": 2,
  "data": [{ "id": "ORDER_ID", "status": "received", "phone": "10000000000" }],
  "first_page_url": "…?page=1",
  "last_page": 4,
  "last_page_url": "…?page=4",
  "next_page_url": "…?page=3",
  "per_page": 100,
  "prev_page_url": "…?page=1",
  "total": 350
}

Errors

next_page_url이 null이 될 때까지 따라가세요. page의 기본값은 1이고, per_page의 기본값은 20이며 값은 1–100으로 제한됩니다. status는 active, completed/received, cancelled, expired, refunded를 받으며, all 또는 알 수 없는 값은 status를 필터링하지 않습니다. search는 전화번호와 일치합니다. category는 rents, links, numbers를 받으며 알 수 없는 카테고리는 무시됩니다. 내역이 많으면 여러 번의 페이지 요청이 필요합니다.

임대

GET/rent/services국가와 기간별 임대 서비스를 확인합니다.

API 키가 필요합니다.

매개변수

country
선택 정수 국가 ID. 기본값은 2.
duration
선택 시간. 기본값은 24. 허용 범위: 24–1,344시간.

요청 예시

curl 'https://api.smsactivate.uk/rent/services?country=2&duration=24' -H "X-API-KEY: YOUR_API_KEY"

응답

Returns rental availability, with service codes and current prices for the selected country and duration.

Errors

HTTP 400: 선택한 조건에 사용 가능한 임대 번호가 없습니다. HTTP 422: 잘못된 국가 또는 기간. HTTP 503: 임대 카탈로그를 일시적으로 사용할 수 없습니다.

POST/rent/order임대 주문을 생성합니다.

API 키가 필요합니다.

매개변수

service
필수 서비스 코드(문자열).
country
필수 국가 ID(정수).
duration
필수 시간, 24–1,344.
operator
선택 문자열. 기본값은 any.

요청 예시

curl -X POST https://api.smsactivate.uk/rent/order \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"service":"tg","country":2,"duration":24}'

응답

{
  "message": "Number rented successfully.",
  "id": "ORDER_ID",
  "phone": "10000000000",
  "price": 2.50,
  "balance_remaining": 7.50
}

Errors

HTTP 400: 잘못된 요청 또는 잔액 부족. HTTP 409: 사용 가능한 임대가 없습니다. HTTP 503: 결과가 검토 대기 중입니다. 지원팀이 주문을 확인할 때까지 재시도하지 마세요.

POST/rent/cancel/{order_id}취소 가능한 임대의 취소를 요청합니다.

API 키가 필요합니다.

매개변수

order_id
필수 경로 값. 요청 본문 없음.

요청 예시

curl -X POST https://api.smsactivate.uk/rent/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the cancellation result. Refunds may remain pending verification after cancellation is accepted.

Errors

취소는 구매 후 2~20분 사이이고 SMS가 도착하기 전의 취소 가능한 활성 임대로 제한됩니다. HTTP 404: 임대를 찾을 수 없습니다. HTTP 409: 임대가 취소 대상이 아닙니다. 승인되면 환불은 확인 대기 상태로 남을 수 있습니다.

GET/rent/extend/{order_id}/options임대에 사용 가능한 연장 옵션을 확인합니다.

API 키가 필요합니다.

매개변수

order_id
임대의 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/rent/extend/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "options": [{ "duration": 24, "price": 2.50 }],
  "expires_at": "2026-10-06T12:00:00Z"
}

Errors

HTTP 404: 임대를 찾을 수 없습니다. HTTP 409: 임대가 연장 대상이 아닙니다(연장은 처음 20분 이후에 열리며, 임대는 active 또는 received 상태여야 하고, 이전 연장이 검토 대기 중이 아니어야 합니다). HTTP 503: 연장을 일시적으로 사용할 수 없거나 옵션을 불러오지 못했습니다. 나중에 다시 시도하세요. 이 엔드포인트에는 요청 제한이 있습니다.

POST/rent/extend/{order_id}활성 임대를 연장합니다.

API 키가 필요합니다.

매개변수

order_id
임대의 필수 경로 값입니다.
duration
필수: 24, 72, 168, 336, 720, 1,440, 2,160 또는 4,320시간. 현재 옵션 응답에서 선택하세요.
expected_price
현재 옵션 응답에서 복사한 필수 숫자.
Idempotency-Key
필수 UUID v4 요청 헤더. 동일한 연장 시도를 안전하게 재시도할 때만 재사용하세요.

요청 예시

curl -X POST https://api.smsactivate.uk/rent/extend/ORDER_ID \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f6c1a52-8b1e-4c47-9d0a-6a1f2c9e7b10" \
  -d '{"duration":24,"expected_price":2.50}'

응답

{
  "message": "Rental extended successfully.",
  "attempt_id": "REQUEST_UUID",
  "status": "settled",
  "charged": 2.50,
  "new_expires_at": "2026-10-10T12:00:00Z",
  "balance_remaining": 7.50
}

Errors

HTTP 422: duration, expected_price 또는 Idempotency-Key가 없거나 잘못되었습니다. HTTP 409: 임대가 연장 대상이 아니거나, 기간 또는 가격이 더 이상 제공되지 않거나, Idempotency-Key가 이미 사용되었습니다. HTTP 202: 연장이 검토 대기 중입니다. 새 멱등성 키로 재시도하지 마세요. HTTP 503: 연장을 확인하지 못했습니다. 지원팀에 문의하세요.

이메일 인증

GET/emails/catalog?site={site}사이트에 사용 가능한 인증 주소 도메인 목록을 조회합니다.

API 키가 필요합니다.

매개변수

site
필수 웹사이트 도메인, 예: example.com.

요청 예시

curl 'https://api.smsactivate.uk/emails/catalog?site=example.com' -H "X-API-KEY: YOUR_API_KEY"

응답

[{ "name": "sample-domain.test", "price": 0.10, "stock": 5 }]

Errors

HTTP 422: 잘못된 site 값. HTTP 503: 이메일 카탈로그를 일시적으로 사용할 수 없습니다.

POST/emails/buy인증 주소 하나를 구매합니다.

API 키가 필요합니다.

매개변수

site
필수 웹사이트 도메인.
domain
현재 카탈로그 응답에서 선택한 필수 도메인.

요청 예시

curl -X POST https://api.smsactivate.uk/emails/buy \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"site":"example.com","domain":"sample-domain.test"}'

응답

Returns an order object and balance_remaining when the purchase is confirmed.

Errors

HTTP 400: 지갑 잔액 부족. HTTP 409: 도메인 재고 없음. HTTP 503: 구매가 검토 대기 중입니다. 지원팀이 주문을 확인할 때까지 재시도하지 마세요.

POST/emails/{order_id}/reorder이전 주문이 끝난 뒤 같은 주소를 다시 주문합니다.

API 키가 필요합니다.

매개변수

order_id
완료된 이메일 주문의 필수 경로 값(숫자). 요청 본문 없음.

요청 예시

curl -X POST https://api.smsactivate.uk/emails/ORDER_ID/reorder -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the new email order, same shape as the email order response. The price is quoted at order time and charged from your balance.

Errors

HTTP 404: 주문을 찾을 수 없습니다. HTTP 409: 이전 주문이 끝나지 않았거나, 재주문이 이미 진행 중이거나, 이 주소를 지금은 재주문할 수 없습니다. HTTP 503: 이메일 인증을 일시적으로 사용할 수 없습니다. 이 엔드포인트에는 요청 제한이 있습니다.

GET/emails/history이메일 인증 주문 목록을 조회합니다.

API 키가 필요합니다.

매개변수

page
선택 페이지 번호. 기본값은 1.
per_page
선택 페이지 크기. 기본값은 20이며 최대 50입니다.

요청 예시

curl 'https://api.smsactivate.uk/emails/history?page=1&per_page=20' -H "X-API-KEY: YOUR_API_KEY"

응답

Returns paginated order data and page metadata.

Errors

이메일 주문 테이블을 사용할 수 없으면 API는 빈 data 배열을 반환합니다.

GET/emails/status/{order_id}인증 주문을 조회하거나 새로 고칩니다.

API 키가 필요합니다.

매개변수

order_id
구매 응답에서 반환된 필수 경로 값입니다.

요청 예시

curl https://api.smsactivate.uk/emails/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the order status and available verification result fields.

Errors

HTTP 404: 주문을 찾을 수 없습니다. HTTP 503: 상태를 새로 고치지 못했습니다. 응답에는 주문에 사용 가능한 필드만 포함됩니다.

DELETE/emails/{order_id}이메일 인증 주문의 취소를 요청합니다.

API 키가 필요합니다.

매개변수

order_id
구매 응답에서 반환된 필수 경로 값입니다.

요청 예시

curl -X DELETE https://api.smsactivate.uk/emails/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the cancellation result. The refund can remain pending verification.

Errors

주문은 내 계정 소속이어야 하고 취소 가능해야 합니다. 현재 주문 상태는 반환된 오류 메시지를 확인하세요. 응답에 취소가 아직 확인되지 않았다고 나오면(HTTP 503) 몇 분 기다린 뒤 요청을 다시 보내세요.

웹훅

GET/webhook웹훅 설정을 조회합니다.

API 키가 필요합니다.

매개변수

없음
쿼리 매개변수가 없습니다.

요청 예시

curl https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"

응답

Returns the saved endpoint configuration. The signing secret is not returned by this read request.

Errors

인증된 계정의 현재 설정을 반환합니다.

PUT/webhook웹훅 URL을 생성하거나 업데이트합니다.

API 키가 필요합니다.

매개변수

url
443 포트의 필수 공개 HTTPS URL. 로컬 및 사설 주소는 거부됩니다.

요청 예시

curl -X PUT https://api.smsactivate.uk/webhook \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/sms"}'

응답

Returns the saved configuration. On first setup the signing secret is returned once; store it safely.

Errors

HTTP 422: URL이 허용되는 공개 HTTPS 주소가 아닙니다.

POST/webhook/rotate-secret설정된 웹훅의 서명 시크릿을 교체합니다.

API 키가 필요합니다.

매개변수

없음
요청 본문 없음. 먼저 웹훅을 설정하세요.

요청 예시

curl -X POST https://api.smsactivate.uk/webhook/rotate-secret -H "X-API-KEY: YOUR_API_KEY"

응답

{ "secret": "NEW_SECRET_SHOWN_ONCE" }

Errors

HTTP 404: 설정된 웹훅이 없습니다. 새 시크릿은 안전하게 저장하세요. 읽기 엔드포인트가 아니라 이 교체 응답에서 반환됩니다.

DELETE/webhook웹훅 설정을 삭제합니다.

API 키가 필요합니다.

매개변수

없음
요청 본문 없음.

요청 예시

curl -X DELETE https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"

응답

{ "configured": false }

Errors

인증된 계정의 웹훅 설정을 삭제합니다.

POST/webhook/test설정된 엔드포인트로 테스트 이벤트를 보냅니다.

API 키가 필요합니다.

매개변수

없음
요청 본문 없음. 먼저 웹훅을 설정하세요.

요청 예시

curl -X POST https://api.smsactivate.uk/webhook/test -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "delivered": true,
  "http_status": 200,
  "message": "Your server accepted the test message."
}

Errors

HTTP 404: 설정된 웹훅이 없습니다. 서버가 수락하지 않으면 테스트 전송은 delivered=false로 보고합니다.

GET/webhook/deliveries최근 웹훅 전송 시도를 최대 50건까지 확인합니다.

API 키가 필요합니다.

매개변수

없음
쿼리 매개변수가 없습니다.

요청 예시

curl https://api.smsactivate.uk/webhook/deliveries -H "X-API-KEY: YOUR_API_KEY"

응답

{
  "data": [{ "id": 42, "event_id": "EVENT_ID", "event_type": "sms.received", "status": "success", "attempts": 1, "http_status": 200 }]
}

Errors

가장 최근의 HTTP 웹훅 전송 50건을 최신순으로 반환합니다.

POST/webhook/deliveries/{id}/retry웹훅 전송 중 하나를 지금 다시 시도합니다.

API 키가 필요합니다.

매개변수

id
전송 기록의 필수 경로 값입니다.

요청 예시

curl -X POST https://api.smsactivate.uk/webhook/deliveries/42/retry -H "X-API-KEY: YOUR_API_KEY"

응답

{ "status": "success", "http_status": 200 }

Errors

HTTP 404: 전송 기록을 찾을 수 없습니다. 이 엔드포인트에는 요청 제한이 있습니다.

4. 결제

주문 시 잔액에서 금액이 차감됩니다. 20분 제한 시간 내에 SMS를 받지 못한 활성화는 잔액으로 환불됩니다. 취소 및 환불 규칙은 임대, 이메일, API Links마다 다릅니다.

5. 취소 및 환불

번호 주문(활성화)은 처음 2분이 지난 후 20분 활성화 시간이 끝나기 전까지, SMS가 도착하지 않은 경우에만 취소를 요청할 수 있습니다. 적격 조건을 충족해 확인된 취소는 주문 금액을 잔액으로 환불합니다.

SMS가 도착했거나 활성화 시간이 끝난 후에는 활성화를 취소할 수 없습니다. 적격 활성화가 20분 동안 SMS를 받지 못하면 주문 금액이 잔액으로 환불됩니다.

임대는 코드가 도착하지 않았다면 같은 2~20분 구간에서 취소할 수 있습니다. 임대 환불은 확인 후 처리되며 자동으로 이루어지지 않습니다.

대량 번호, API Links, 이메일 주문은 대시보드에 별도로 명시되지 않는 한 전달 후 환불되지 않습니다.

취소를 확인할 수 없는 경우 다시 시도하기 전에 고객 지원에 문의하세요.

Frequently asked questions

How do I authenticate with the API?

Create or rotate a key in your dashboard. Send it in the X-API-KEY header with every request. The key is shown once when you create or rotate it. Keep it server-side. Open your dashboard.

What do I need for my first order?

A service code and a numeric country ID. Find them with GET /services and GET /countries/{service}, then check GET /offers/{service}/{country}. Prices are shown live in the dashboard. See live prices.

How do I read the code that arrives?

Poll GET /status/{order_id} and read sms_code when the status is received. GET /sms/{order_id} is rate-limited; do not use it for routine polling.

What if no SMS arrives?

An eligible activation with no SMS in its 20-minute window is refunded. You can also cancel an eligible active activation 2 to 20 minutes after purchase, before an SMS arrives. If a purchase response is uncertain, do not retry it; contact support. Read the FAQ.

Can I cancel an order?

For eligible active activations: POST /cancel/{order_id}, 2 to 20 minutes after purchase, before an SMS arrives. Rentals use POST /rent/cancel/{order_id}. API Links are final sale.

Does this API send verification codes to my users?

No. It receives codes on a number you order. If you need to send codes to your own users, this API is not the tool for that job.

How do webhooks work?

Set a public HTTPS URL on port 443 with PUT /webhook; the signing secret is returned once. Verify the signature as sha256= HMAC-SHA256 of "." and reject timestamps more than five minutes old. Test with POST /webhook/test.

더 높은 요청 한도나 맞춤 통합이 필요하신가요? 팀에 문의하기. 또는 대시보드 열기.