Geliştirici rehberi

Geliştirici belgeleri

SMS Activate, geçici telefon numaralarını ölçekli şekilde kiralaması gereken kullanıcılar için tam otomatik bir API sunar.

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.

Başlarken

Panelinizde bir API anahtarı oluşturun, ardından sunucu tarafı bir istekte kullanın.

Gerçek bir API anahtarını asla tarayıcı koduna, ekran görüntülerine veya herkese açık depolara koymayın.

API anahtarlarını aç

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. Kimlik doğrulama

API anahtarınızı panel ayarlarınızdan alın. Tüm API istekleri şu başlığı içermelidir:

X-API-KEY: your_api_key_here

2. Temel URL

Tüm API istekleri bu temel URL'yi kullanır:

https://api.smsactivate.uk

Örnek istek

Bu istek sipariş verir ve cüzdanınızdan ücret alabilir. Örnek hizmeti ve ülkeyi hesabınızda kullanılabilir bir seçimle değiştirin.

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 referansı

Her işlem girdilerini, bir örnek isteği, temsili bir yanıtı ve başlıca hataları listeler. Mevcut API entegrasyonları önceki endpoint'lerini kullanmaya devam edebilir; yeni entegrasyonlar için aşağıdaki ürün tabanlı endpoint'ler önerilir. Örneklerde yer tutucu ID ve değerler kullanılır. Kimliği doğrulanmış istekleri sunucunuzdan API anahtarı başlığıyla gönderin.

Buradan başlayın

GET/balanceCüzdanınızın güncel bakiyesini okuyun.

API anahtarı gerekir.

Parametreler

Yok
Sorgu parametresi yok.

Örnek istek

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

Yanıt

{ "balance": "10.0000" }

Errors

Endpoint, kimliği doğrulanmış hesabın güncel bakiyesini döndürür.

Numara alma ve yönetme

POST/get_numbersBir aktivasyon siparişi verin.

API anahtarı gerekir.

Parametreler

service
Zorunlu dize. Hizmet kodu, örneğin tg.
country
Zorunlu tam sayı. Sayısal ülke ID'si.
operator
İsteğe bağlı dize. Varsayılan any.
max_price
İsteğe bağlı sayı. Azami fiyat; maxPrice de kabul edilir.
min_price
İsteğe bağlı sayı; minPrice de kabul edilir.
any_price
İsteğe bağlı boolean; anyPrice de kabul edilir.
product
İsteğe bağlı: standard (varsayılan) veya api_links. API Links, iadesiz envanter satın alımlarıdır.
idempotency_key
Standart aktivasyonlar için isteğe bağlı UUID. Aynı anahtarı yalnızca sonucu kontrol edilen aynı satın alma isteği için yeniden kullanın.
quantity
API Links envanter siparişleri için 1 ile 100 arasında isteğe bağlı tam sayı; varsayılan 1. Standart aktivasyon siparişleri tek numaralıdır.

Örnek istek

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}'

Yanıt

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

Errors

HTTP 400: seçim kullanılamıyor, fiyat sınırı veya yetersiz bakiye. HTTP 409: önceki bir sipariş hâlâ kontrol ediliyor. HTTP 503: geçici hata veya belirsiz sipariş; yanıtta mutabakat gerektiği belirtiliyorsa yeniden denemeyin ve destekle iletişime geçin.

GET/sms/{order_id}Aktif bir sipariş için yeni bir durum kontrolü isteyin.

API anahtarı gerekir. Bu endpoint'te istek sınırı vardır.

Parametreler

order_id
Sipariş oluşturulduğunda dönen zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: bu sipariş için SMS kontrolü kullanılamıyor. HTTP 404: sipariş bulunamadı. HTTP 502: geçici kontrol hatası. Süresi dolmuş siparişler, yeni bir harici kontrol yapılmadan kayıtlı durumlarını döndürür.

GET/status/{order_id}Bir siparişin durumunu ve alınan SMS'leri okuyun.

API anahtarı gerekir.

Parametreler

order_id
Sipariş oluşturulduğunda dönen zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

Yanıt, kimliği doğrulanmış hesabın siparişiyle sınırlıdır. Durum sorgusu başarısız olursa API bir hata döndürür; sipariş ID'sini kontrol edin ve hizmet geçici olarak kullanılamıyorsa daha sonra tekrar deneyin.

POST/resend/{order_id}Desteklenen aktif bir aktivasyon için başka bir SMS isteyin.

API anahtarı gerekir.

Parametreler

order_id
Zorunlu yol değeri. İstek gövdesi yok.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: yeniden gönderim kabul edilmedi veya sipariş süresi doldu. HTTP 409: bu sipariş için yeniden gönderim kullanılamıyor. HTTP 500: yeniden gönderim tamamlanamadı.

POST/cancel/{order_id}Uygun bir aktivasyonun iptalini isteyin.

API anahtarı gerekir.

Parametreler

order_id
Zorunlu yol değeri. İstek gövdesi yok.

Örnek istek

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

Yanıt

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

Errors

İptal yalnızca uygun aktif aktivasyonlar için, satın almadan 2 ila 20 dakika sonra ve SMS gelmeden önce mümkündür. Kiralamalar /rent/cancel/{order_id} kullanır; API Links iadesizdir. Uygun olmayan veya onaylanmayan iptaller hata döndürür. Yeniden denemeden önce iptal yanıtını okuyun.

GET/reactivate/{order_id}/optionsGüncel yeniden aktivasyon fiyatını ve ayrıntılarını kontrol edin.

API anahtarı gerekir.

Parametreler

order_id
Asıl siparişin zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: yeniden aktivasyon desteklenmiyor veya kullanılamıyor. HTTP 409: bu sipariş için yeniden aktivasyon kullanılamıyor. HTTP 503: geçerli bir güncel fiyat doğrulanamadı.

POST/reactivate/{order_id}Uygun bir aktivasyonu güncel fiyatla yeniden etkinleştirin.

API anahtarı gerekir.

Parametreler

order_id
Asıl siparişin zorunlu yol değeri. İstek gövdesi yok.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: yeniden aktivasyon desteklenmiyor veya cüzdan bakiyesi yetersiz. HTTP 409: bu sipariş için kullanılamıyor. HTTP 503: sonuç doğrulanamadı; yeniden denemeden önce destekle iletişime geçin.

GET/orders/{order_id}Siparişlerinizden birinin ayrıntılarını okuyun.

API anahtarı gerekir.

Parametreler

order_id
Sipariş oluşturulduğunda dönen zorunlu yol değeri.

Örnek istek

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

Yanıt

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: sipariş bulunamadı veya hesabınıza ait değil.

Hizmet, ülke ve fiyat seçme

HizmetlerHizmet kataloğunda ada veya koda göre arayın. Stok durumu değişebilir; sipariş vermeden önce canlı endpoint'i kontrol edin.
Ad / kod1,638 katalog girişi
  • 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

Canlı stok durumu ve örnek yanıt:

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

Katalog, arama için adlar ve kodlar sağlar. Stok durumu canlıdır ve bu listeden farklı olabilir; bu JSON yanıtın biçimini gösterir, güncel envanteri değil.

ÜlkelerPanel kataloğundaki sayısal ülke ID'leri. Standart aktivasyonlar için genel bir ülke listesi API endpoint'i yoktur.
Ülke / sayısal ID206 katalog girişi
  • 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

Bir hizmet ve ülke için teklif yanıtı biçimi:

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

Katalog ID'leri ülke seçeneklerini tanımlar, canlı tekliflerin varlığını garanti etmez. Stok durumu için /offers/{service}/{country} adresini kontrol edin.

GET/servicesHizmetlerin güncel stok durumunu kontrol edin.

Herkese açık - API anahtarı gerekmez.

Parametreler

Yok
Bu endpoint sorgu parametresi almaz.

Örnek istek

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

Yanıt

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

Stok durumu değişebilir. Sipariş vermeden önce canlı endpoint'i ve /offers/{service}/{country} adresini kontrol edin.

GET/countries/{service}Bir hizmet için şu anda numarası bulunan ülke ID'lerini listeleyin.

Herkese açık - API anahtarı gerekmez.

Parametreler

service
Zorunlu hizmet kodu, örneğin tg.

Örnek istek

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

Yanıt

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

Errors

Ülke ID'leri aşağıdaki Ülkeler kataloğuyla eşleşir. Stok durumu değişir; sipariş vermeden önce /offers/{service}/{country} adresini kontrol edin. Bu endpoint'te istek sınırı vardır.

GET/offers/{service}/{country}/deliveryHer fiyat kademesi için son kod teslim oranlarını görün.

Herkese açık - API anahtarı gerekmez.

Parametreler

service
Zorunlu hizmet kodu, örneğin tg.
country
Zorunlu sayısal ülke ID'si.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: geçersiz hizmet veya ülke. Teslim edilmiş kodu olmayan kademeler listelenmez. Sonuçlar yaklaşık 5 dakika önbelleğe alınır ve son window_days günü kapsar. Bu endpoint'te istek sınırı vardır.

GET/operators?service={service}&country={country}Bir hizmet ve ülke için kullanılabilir operatörleri listeleyin.

Herkese açık - API anahtarı gerekmez.

Parametreler

service
Zorunlu hizmet kodu, örneğin tg.
country
Zorunlu sayısal ülke ID'si.

Örnek istek

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

Yanıt

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

Errors

Liste, seçilen ülkeye ve güncel stok durumuna bağlıdır. service ve country ikisi de zorunludur; eksik veya geçersiz değerler HTTP 422 döndürür.

GET/offers/{service}/{country}Tek bir hizmet ve ülke kombinasyonu için teklifleri kontrol edin.

Herkese açık - API anahtarı gerekmez.

Parametreler

service
Zorunlu yol değeri. /services'in döndürdüğü bir hizmet kodunu kullanın, örneğin tg.
country
Zorunlu yol değeri. Sayısal ülke ID'si; standart aktivasyonlar için panelin ülke kataloğunu kullanın. Bu ülke ID'lerini listeleyen genel bir API endpoint'i yoktur.

Örnek istek

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

Yanıt

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

Errors

Desteklenmeyen veya kullanılamayan bir çift boş liste döndürebilir. Teklif verileri önbelleğe alınır; önbellekte yoksa stok kontrol edilirken yanıt daha uzun sürebilir.

Geçmiş etkinliğe göz atma

GET/ordersSipariş geçmişinize en yeniden eskiye doğru göz atın.

API anahtarı gerekir.

Parametreler

page
İsteğe bağlı sayfa numarası; varsayılan 1.
per_page
İsteğe bağlı sayfa boyutu; varsayılan 20, üst sınır 100.
status
İsteğe bağlı: active, completed (veya received), cancelled, expired, refunded. Tüm durumları dahil etmek için boş bırakın veya all kullanın.
search
İsteğe bağlı telefon numarası araması.
category
İsteğe bağlı: rents, links veya numbers.

Örnek istek

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

Yanıt

{
  "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 olana kadar takip edin. page varsayılan olarak 1'dir; per_page varsayılan olarak 20'dir ve değerler 1–100 aralığına sıkıştırılır. status active, completed/received, cancelled, expired veya refunded kabul eder; all veya bilinmeyen bir değer status'u filtresiz bırakır. search telefon numaralarıyla eşleşir. category rents, links veya numbers kabul eder; bilinmeyen kategoriler yok sayılır. Büyük geçmişler birden fazla sayfa isteği gerektirir.

Kiralamalar

GET/rent/servicesBir ülke ve süre için kiralama hizmetlerini kontrol edin.

API anahtarı gerekir.

Parametreler

country
İsteğe bağlı tam sayı ülke ID'si; varsayılan 2.
duration
İsteğe bağlı saat; varsayılan 24. İzin verilen aralık: 24–1.344 saat.

Örnek istek

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

Yanıt

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

Errors

HTTP 400: seçim için kiralık numara yok. HTTP 422: geçersiz ülke veya süre. HTTP 503: kiralama kataloğu geçici olarak kullanılamıyor.

POST/rent/orderBir kiralama siparişi verin.

API anahtarı gerekir.

Parametreler

service
Zorunlu hizmet kodu (dize).
country
Zorunlu ülke ID'si (tam sayı).
duration
Zorunlu saat, 24–1.344.
operator
İsteğe bağlı dize; varsayılan any.

Örnek istek

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}'

Yanıt

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

Errors

HTTP 400: geçersiz istek veya yetersiz bakiye. HTTP 409: kiralama yok. HTTP 503: sonuç incelemede; destek siparişi kontrol edene kadar yeniden denemeyin.

POST/rent/cancel/{order_id}Uygun bir kiralamanın iptalini isteyin.

API anahtarı gerekir.

Parametreler

order_id
Zorunlu yol değeri. İstek gövdesi yok.

Örnek istek

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

Yanıt

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

Errors

İptal, uygun aktif kiralamalarla, satın almadan 2 ila 20 dakika sonra ve SMS gelmeden önce sınırlıdır. HTTP 404: kiralama bulunamadı. HTTP 409: kiralama uygun değil. Kabul edilirse iadesi doğrulama bekleyebilir.

GET/rent/extend/{order_id}/optionsBir kiralama için kullanılabilir uzatma seçeneklerini kontrol edin.

API anahtarı gerekir.

Parametreler

order_id
Kiralamanın zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

HTTP 404: kiralama bulunamadı. HTTP 409: kiralama uygun değil (uzatma ilk 20 dakikadan sonra açılır, kiralama active veya received olmalıdır ya da önceki bir uzatma incelemede bekliyor). HTTP 503: uzatma geçici olarak kullanılamıyor veya seçenekler yüklenemedi; daha sonra tekrar deneyin. Bu endpoint'te istek sınırı vardır.

POST/rent/extend/{order_id}Aktif bir kiralamayı uzatın.

API anahtarı gerekir.

Parametreler

order_id
Kiralamanın zorunlu yol değeri.
duration
Zorunlu: 24, 72, 168, 336, 720, 1.440, 2.160 veya 4.320 saat. Güncel seçenekler yanıtından seçin.
expected_price
Güncel seçenekler yanıtından kopyalanan zorunlu sayı.
Idempotency-Key
Zorunlu UUID v4 istek başlığı. Yalnızca aynı uzatma denemesini güvenle yeniden denemek için tekrar kullanın.

Örnek istek

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}'

Yanıt

{
  "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 veya Idempotency-Key eksik/geçersiz. HTTP 409: kiralama uygun değil, süre veya fiyat artık sunulmuyor ya da Idempotency-Key daha önce kullanılmış. HTTP 202: uzatma incelemede; yeni bir idempotency anahtarıyla yeniden denemeyin. HTTP 503: uzatma doğrulanamadı; destekle iletişime geçin.

E-posta doğrulama

GET/emails/catalog?site={site}Bir site için kullanılabilir doğrulama adresi alan adlarını listeleyin.

API anahtarı gerekir.

Parametreler

site
Zorunlu web sitesi alan adı, örneğin example.com.

Örnek istek

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

Yanıt

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

Errors

HTTP 422: geçersiz site değeri. HTTP 503: e-posta kataloğu geçici olarak kullanılamıyor.

POST/emails/buyBir doğrulama adresi satın alın.

API anahtarı gerekir.

Parametreler

site
Zorunlu web sitesi alan adı.
domain
Güncel katalog yanıtından seçilen zorunlu alan adı.

Örnek istek

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"}'

Yanıt

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

Errors

HTTP 400: cüzdan bakiyesi yetersiz. HTTP 409: alan adı stokta yok. HTTP 503: satın alma incelemede; destek siparişi kontrol edene kadar yeniden denemeyin.

POST/emails/{order_id}/reorderÖnceki sipariş bittikten sonra aynı adresi yeniden sipariş edin.

API anahtarı gerekir.

Parametreler

order_id
Tamamlanmış bir e-posta siparişinin zorunlu yol değeri (sayısal). İstek gövdesi yok.

Örnek istek

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

Yanıt

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: sipariş bulunamadı. HTTP 409: önceki sipariş bitmedi, yeniden sipariş zaten sürüyor veya bu adres şu anda yeniden sipariş edilemiyor. HTTP 503: e-posta doğrulamaları geçici olarak kullanılamıyor. Bu endpoint'te istek sınırı vardır.

GET/emails/historyE-posta doğrulama siparişlerinizi listeleyin.

API anahtarı gerekir.

Parametreler

page
İsteğe bağlı sayfa numarası; varsayılan 1.
per_page
İsteğe bağlı sayfa boyutu; varsayılan 20, üst sınır 50.

Örnek istek

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

Yanıt

Returns paginated order data and page metadata.

Errors

E-posta sipariş tablosu kullanılamıyorsa API boş bir data dizisi döndürür.

GET/emails/status/{order_id}Bir doğrulama siparişini okuyun veya yenileyin.

API anahtarı gerekir.

Parametreler

order_id
Satın alma yanıtının döndürdüğü zorunlu yol değeri.

Örnek istek

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

Yanıt

Returns the order status and available verification result fields.

Errors

HTTP 404: sipariş bulunamadı. HTTP 503: durum yenilenemedi. Yanıt yalnızca sipariş için mevcut alanları içerir.

DELETE/emails/{order_id}Bir e-posta doğrulama siparişinin iptalini isteyin.

API anahtarı gerekir.

Parametreler

order_id
Satın alma yanıtının döndürdüğü zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

Sipariş hesabınıza ait olmalı ve iptale uygun olmalıdır; siparişin güncel durumu için dönen hata mesajına bakın. Yanıt iptalin henüz onaylanmadığını belirtiyorsa (HTTP 503), birkaç dakika bekleyip isteği yeniden gönderin.

Webhook'lar

GET/webhookWebhook yapılandırmanızı okuyun.

API anahtarı gerekir.

Parametreler

Yok
Sorgu parametresi yok.

Örnek istek

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

Yanıt

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

Errors

Kimliği doğrulanmış hesabın güncel yapılandırmasını döndürür.

PUT/webhookWebhook URL'nizi oluşturun veya güncelleyin.

API anahtarı gerekir.

Parametreler

url
443 portunda zorunlu herkese açık HTTPS URL'si. Yerel ve özel adresler reddedilir.

Örnek istek

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"}'

Yanıt

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

Errors

HTTP 422: URL kabul edilen bir herkese açık HTTPS adresi değil.

POST/webhook/rotate-secretYapılandırılmış webhook'unuzun imza sırrını değiştirin.

API anahtarı gerekir.

Parametreler

Yok
İstek gövdesi yok. Önce bir webhook yapılandırın.

Örnek istek

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

Yanıt

{ "secret": "NEW_SECRET_SHOWN_ONCE" }

Errors

HTTP 404: yapılandırılmış webhook yok. Yeni sırrı güvenli şekilde saklayın; okuma endpoint'i tarafından değil, bu yenileme yanıtıyla döndürülür.

DELETE/webhookWebhook yapılandırmanızı kaldırın.

API anahtarı gerekir.

Parametreler

Yok
İstek gövdesi yok.

Örnek istek

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

Yanıt

{ "configured": false }

Errors

Kimliği doğrulanmış hesabın webhook yapılandırmasını kaldırır.

POST/webhook/testYapılandırılmış endpoint'inize bir test olayı gönderin.

API anahtarı gerekir.

Parametreler

Yok
İstek gövdesi yok. Önce bir webhook yapılandırın.

Örnek istek

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

Yanıt

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

Errors

HTTP 404: yapılandırılmış webhook yok. Sunucunuz kabul etmezse test teslimi delivered=false bildirir.

GET/webhook/deliveriesSon 50 webhook teslim denemesine kadar inceleyin.

API anahtarı gerekir.

Parametreler

Yok
Sorgu parametresi yok.

Örnek istek

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

Yanıt

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

Errors

En yeniden eskiye doğru en son 50 HTTP webhook teslimini döndürür.

POST/webhook/deliveries/{id}/retryWebhook teslimlerinizden birini şimdi yeniden deneyin.

API anahtarı gerekir.

Parametreler

id
Teslim kaydının zorunlu yol değeri.

Örnek istek

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

Yanıt

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

Errors

HTTP 404: teslim bulunamadı. Bu endpoint'te istek sınırı vardır.

4. Faturalandırma

Sipariş verdiğinizde bakiyenizden tahsilat yapılır. 20 dakikalık süre içinde SMS almayan aktivasyonlar bakiyenize iade edilir. İptal ve iade kuralları kiralamalar, e-postalar ve API Links için farklıdır.

5. İptal ve İadeler

Numara siparişlerinde (aktivasyonlar), yalnızca henüz SMS gelmemişse, ilk 2 dakikadan sonra ve 20 dakikalık aktivasyon süresi bitmeden iptal isteyebilirsiniz. Uygun ve onaylanan iptaller sipariş tutarını bakiyenize iade eder.

Bir aktivasyon, SMS geldikten sonra veya süresi bittikten sonra iptal edilemez. Uygun bir aktivasyon 20 dakikalık süre boyunca SMS almazsa sipariş tutarı bakiyenize iade edilir.

Kiralamalar, henüz kod gelmemişse aynı 2 ila 20 dakikalık aralıkta iptal edilebilir. Kiralama iadesi doğrulama beklemektedir ve otomatik değildir.

Toplu numaralar, API Links ve e-posta siparişleri, panelde aksi belirtilmedikçe teslim edildikten sonra iade edilmez.

Bir iptal onaylanamazsa tekrar denemeden önce destekle iletişime geçin.

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.

Daha yüksek bir limite veya özel bir entegrasyona mı ihtiyacınız var? Ekibimizle iletişime geçin. veya panelinizi açın.