API ডকুমেন্টেশন

iLoveSMS REST API বা SMS-Activate প্রোটোকল দিয়ে নম্বর কেনা স্বয়ংক্রিয় করুন।

আপনার ব্যক্তিগত API কী অ্যাকাউন্ট সেটিংসে আছে। সাইন আপ

REST JSON API v1

বেস URL: https://ilovesms.com.tr/api/v1/ — প্রমাণীকরণ: ?api_key=… / Authorization: Bearer …

Method	প্যারামিটার	বিবরণ
`GET services`	—	সর্বনিম্ন দাম ও স্টকসহ সার্ভিস।
`GET countries`	—	দেশের তালিকা।
`GET prices`	`service`	একটি সার্ভিসের দেশভিত্তিক দাম ও স্টক।
`GET balance`	`api_key`	আপনার ব্যালেন্স।
`POST buy`	`api_key, service, country_id`	নম্বর কিনুন; দাম ব্যালেন্স থেকে কাটা হবে।
`GET status`	`api_key, id`	অর্ডারের অবস্থা ও SMS কোড।
`POST cancel`	`api_key, id`	অপেক্ষমাণ অর্ডার বাতিল ও রিফান্ড।
`POST finish`	`api_key, id`	কোড পাওয়ার পর নম্বর বন্ধ করুন।
`GET orders`	`api_key`	আপনার শেষ ১০০টি অর্ডার।

# 1) নম্বর কিনুন
curl -X POST "https://ilovesms.com.tr/api/v1/buy" -d "api_key=YOUR_API_KEY" -d "service=tg" -d "country_id=12"

{"ok":true,"order":{"id":1042,"service":"Telegram","country":"USA","number":"12025550123",
 "price":0.45,"status":"waiting","code":null,"seconds_left":1200}}

# 2) কোড না আসা পর্যন্ত প্রতি ৫ সেকেন্ডে দেখুন
curl "https://ilovesms.com.tr/api/v1/status?api_key=YOUR_API_KEY&id=1042"

{"ok":true,"order":{"id":1042,"status":"received","code":"48213", ...}}

ত্রুটি কোড: bad_key, bad_service, insufficient, no_numbers, not_cancelable, cancel_later

Webhooks

বারবার যাচাইয়ের বদলে একটি URL দিন; কোড এলে বা অর্ডার রিফান্ড হলে আমরা JSON ইভেন্ট পাঠাব।

POST https://your-server.example/sms-webhook
Content-Type: application/json
X-Event: sms.received          (sms.received | order.refunded | test)
X-Signature: sha256=<hmac_sha256(body, API_KEY)>

{"event":"sms.received","order":{"id":1042,"service":"Telegram","number":"12025550123","status":"received","code":"48213", ...},"sent_at":"2026-10-30T12:00:00+00:00"}

# PHP
$ok = hash_equals('sha256=' . hash_hmac('sha256', file_get_contents('php://input'), API_KEY), $_SERVER['HTTP_X_SIGNATURE']);

৫ সেকেন্ডের মধ্যে HTTP 2xx দিয়ে উত্তর দিন। ওয়েবহুক ঠিকানা সেট করুন: অ্যাকাউন্ট সেটিংস

SMS-Activate সামঞ্জস্যপূর্ণ এন্ডপয়েন্ট

SMS-Activate প্রোটোকলের সফটওয়্যার কোনো পরিবর্তন ছাড়াই চলে: শুধু বেস URL ও API কী বদলান।

https://ilovesms.com.tr/stubs/handler_api.php?api_key=YOUR_API_KEY&action=getBalance        → ACCESS_BALANCE:12.40
...&action=getNumber&service=tg&country=12                    → ACCESS_NUMBER:1042:12025550123
...&action=getStatus&id=1042                                   → STATUS_WAIT_CODE | STATUS_OK:48213
...&action=setStatus&id=1042&status=8                          → ACCESS_CANCEL
...&action=setStatus&id=1042&status=6                          → ACCESS_ACTIVATION
...&action=getPrices&service=tg                                → {"12":{"tg":{"cost":0.45,"count":3120}}}

সার্ভিস কোড ও দেশের ID services ও countries মেথডের মতোই।