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_here2. 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.
163COMwp- 11688
hn - 11and1
ahs - 11xbet
wj - 224betting
lh - 22dehands
apd - 22domains
erc - 22ememain
blx - 22ГИС
bcg - 332Red
qi - 3360Kredi
ayo - 33Fun
auw - 44FunLite
hk - 5500px
fpx - 551exch
boc - 551exchange
exc - 77-Eleven
aws - 8888casino
ll - 9999 Md
brv
99acresfw
99appki- 999Game
qkb - 999k Outlet
amq - AA23
acv - AA9A
gn - AAadhar
hra
Abastece-aíanb- AAbbott
ags
Ace2Threerh- AAcima
cim - AAcko
amf
AdaKamiko- AAdaModal
bdo - AAdani
bq - AAdidas
an - AAditya Birla
qff - AAdmiralBet
bst - AAdobe
byh
Advertsagw- AAEG Presents
rsn - AAffirm
bow - AAfreecaTV
aip
AGIBANKsa- AAgoda
ag
AgriDevelopcs- AAgroinform
qu - AAhlan
bsm - AAiqfome
bbi - AAir Miles
bsy - AAirba Fresh
bnp
Airbnbuk- AAirtasker
byd
Airtelzl- AAirtime
acy
AISwv- AAIS PLAY
axs
Aitujj
Akudorf
Akulakutm
Alchemyaav
Alfabt
Alfagiftbn- AAlfamidi
bgt - AAlFursan
bxr - AAlgida
lp - AAlibaba
ab
AliExpresshx- AAlignable
aul
Alipay/Alibaba/1688hw
All Accessajy
Allegroyn
AlloBanknh- AAllofresh
aeo - AAltyn-i
al - AAmap 高德地图
btx - AAmarthaFin
bsv
Amasiayo- AAmaze Super App
bzk
Amazonam- AAme Digital
afi - AAmway
aee - AAngel One
aha
Ankamaalg- AAnnoncelight
byw
Any Otherot
AOLpm
ApostaGanhaml
Applewx
Apteka Aprelaeh
AptekaRUgk- AAptekiPlus
rq - AAR Lens
aco
ArenaPlusabt- AArgent
amo - AAri10
blq - AASAAS
bqr - AAsda
hs - AAsiaMiles
ajp - AAsianDating
ayb - AAskable
bpi - AAspiration
aptn
Astra Otoshopafd
AstraPayaem
Astropaygr- AASVLA
buj - AAti Su
bhl - AAtlas Earth
awq - AAtlasbus
atb
AttaPollanl- AAUBANK
du
Auchanst- AAudible
aud - AAukro
aox - AAuthentify
ccy - AAuthor24
kd - AAutodesk
bbl
Autoruaej- AAv100pro
ajl - AAvito
av
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.
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/servicesYanı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/tgYanı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/deliveryYanı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/links/optionsAPI Links kataloğundaki hizmetleri ve ülke seçeneklerini listeleyin.
Herkese açık - API anahtarı gerekmez.
Parametreler
- Yok
- Bu endpoint sorgu parametresi almaz.
Örnek istek
curl https://api.smsactivate.uk/links/optionsYanıt
{
"services": [{
"id": "sample_service",
"name": "Sample service",
"countries": [{ "id": 2, "name": "United States", "price": 0.25, "stock": 4 }]
}],
"countries": [{ "id": 2, "name": "United States" }]
}Errors
Bu liste yalnızca API Links içindir. Standart aktivasyon siparişleri için genel bir ülke listesi değildir.
GET/links/offers/{service}/{country}Güncel API Links envanter fiyatlarını ve stoğunu kontrol edin.
Herkese açık - API anahtarı gerekmez.
Parametreler
- service
- API Links seçenek kataloğundan hizmet kodu.
- country
- Seçilen hizmetin API Links ülke listesinden sayısal ülke ID'si.
Örnek istek
curl https://api.smsactivate.uk/links/offers/tg/1Yanıt
[{ "name": "any", "offers": [{ "price": "0.2500", "count": 4 }] }]Errors
Kullanılamayan seçimler boş liste döndürür. Bu ürünü satın almak için /get_numbers adresine product=api_links gönderin. API Links iadesizdir; quantity varsayılan olarak 1'dir ve 1 ile 100 arasında olmalıdı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/2Yanı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 "
Daha yüksek bir limite veya özel bir entegrasyona mı ihtiyacınız var? Ekibimizle iletişime geçin. veya panelinizi açın.
