Sağlayıcı API dokümanı

Başlarken

1. Hesap açın ve satıcı panelinde (Satıcı merkezi) satıcı programına katılın.
2. Satıcı merkezi > API sekmesinden API anahtarınızı (pk_ ile başlar) oluşturun. Anahtar yalnızca bir kez gösterilir.
3. Güvenlik için sunucunuzun IP adreslerini aynı sayfadaki izin listesine ekleyin; liste doluysa başka IP'lerden gelen istekler reddedilir.
4. SIM'lerinizi ekleyin, fiyatınızı girin ve heartbeat göndermeye başlayın. Çevrimiçi SIM'ler hemen satışa çıkar.

Temel bilgiler

Adres

https://smsrota.com/provider/v1

Kimlik doğrulama

Authorization: Bearer pk_… başlığı

Biçim

JSON gövde ve yanıt; tutarlar USD, metin olarak ("0.1200")

Sınır

Anahtar başına dakikada 600 istek

Ülke kodları

SMS-Activate ülke kodları (ör. 16 Birleşik Krallık, 62 Türkiye, 187 ABD)

Servis kodları

SMS-Activate servis kodları (ör. wa WhatsApp, tg Telegram, go Google)

Çalışma akışı

1. Her 25-30 saniyede bir POST /heartbeat gönderin. 90 saniye sessiz kalan SIM satıştan çıkar ve çevrimiçi süre puanınızı düşürür.
2. GET /orders ile 2-5 saniyede bir yeni siparişlere bakın. waiting durumundaki numara bir alıcıya verilmiştir.
3. Numaraya SMS geldiğinde metni olduğu gibi POST /sms ile iletin. Kod otomatik çıkarılır, alıcı anında görür ve kazancınız yazılır.
4. Kazanç 72 saat bekleme süresinden sonra kullanılabilir bakiyeye geçer; panelden ya da POST /payouts ile USDT çekersiniz.
5. Kiralanan SIM'lere (GET /rentals) gelen bütün SMS'leri de /sms ile iletin; kiralama bitince kazanç yazılır.

Uç noktalar

{ "phones": ["447700900001", "447700900002"] }

{ "online": 2 }

[
  {
    "id": 9182,
    "phone": "447700900001",
    "service": "wa",
    "status": "waiting",
    "code": null,
    "createdAt": "2026-11-10T09:00:00.000Z",
    "expiresAt": "2026-11-10T09:20:00.000Z"
  }
]

{ "orderId": 9182, "sender": "WhatsApp", "text": "Your WhatsApp code 123-456" }

{ "accepted": true, "code": "123456" }

[{ "id": 311, "phone": "447700900002", "service": "full", "status": "active", "price": "3.0000", "earning": "2.5500", "sms": 4, "endsAt": "2026-11-11T09:00:00.000Z" }]

[{ "id": 7, "phone": "447700900001", "country": "16", "operator": "EE", "services": [], "enabled": true, "online": true, "busy": false, "delivered": 128 }]

{ "sims": [{ "phone": "447700900001", "country": "16", "operator": "EE", "services": ["wa", "tg"] }] }

{ "ids": [7] }

{ "enabled": false }

{ "ok": true }

{ "prices": [{ "service": "*", "country": "16", "price": 0.12 }, { "service": "wa", "country": "16", "price": 0.18 }] }

{ "ok": true }

{ "prices": [{ "country": "16", "dayPrice": 1.5 }] }

{ "ok": true }

{
  "status": "active",
  "score": 88.5,
  "tier": "A",
  "commission": 0.15,
  "balances": { "pending": "12.4800", "available": "41.2000", "deposit": "50.0000", "depositRequired": "62.0000" },
  "sims": { "total": 12, "online": 11, "busy": 3 },
  "hasKey": true
}

{
  "days": [{ "day": "2026-11-10", "orders": 42, "delivered": 37, "earned": "4.4400", "rentals": 1 }],
  "services": [{ "service": "wa", "orders": 30, "delivered": 28, "earned": "3.3600", "successRate": 93.3 }],
  "countries": [{ "country": "16", "orders": 42, "delivered": 37, "earned": "4.4400", "successRate": 88.1 }],
  "sims": [{ "id": 7, "phone": "447700900001", "orders": 9, "delivered": 9, "earned": "1.0800", "successRate": 100, "uptime": 99.2 }]
}

[{ "id": 55, "kind": "earning", "amount": "0.1020", "bucket": "pending", "createdAt": "…" }]

{ "amount": 40, "address": "TQ…" }

{ "id": 18 }

Örnek kod

Heartbeat, sipariş takibi ve SMS iletme için hazır örnekler. pk_... yerine kendi anahtarınızı yazın.

cURL

# Heartbeat
curl -X POST https://smsrota.com/provider/v1/heartbeat \
  -H "Authorization: Bearer pk_..." -H "Content-Type: application/json" -d '{}'

# Open orders
curl https://smsrota.com/provider/v1/orders -H "Authorization: Bearer pk_..."

# Forward an SMS
curl -X POST https://smsrota.com/provider/v1/sms \
  -H "Authorization: Bearer pk_..." -H "Content-Type: application/json" \
  -d '{"phone":"447700900001","sender":"WhatsApp","text":"Your WhatsApp code 123-456"}'

Python

import threading, time, requests

API = "https://smsrota.com/provider/v1"
H = {"Authorization": "Bearer pk_..."}

def heartbeat():
    while True:
        requests.post(f"{API}/heartbeat", json={}, headers=H, timeout=10)
        time.sleep(25)

threading.Thread(target=heartbeat, daemon=True).start()

def on_sms(phone, sender, text):
    # Call this from your modem / SIM bank software for every incoming SMS.
    r = requests.post(f"{API}/sms", json={"phone": phone, "sender": sender, "text": text}, headers=H, timeout=10)
    print(r.json())

while True:
    for o in requests.get(f"{API}/orders", headers=H, timeout=10).json():
        if o["status"] == "waiting":
            print("waiting for SMS on", o["phone"], "for", o["service"])
    time.sleep(3)

Node.js

const API = "https://smsrota.com/provider/v1";
const headers = { Authorization: "Bearer pk_...", "Content-Type": "application/json" };

setInterval(() => fetch(`${API}/heartbeat`, { method: "POST", headers, body: "{}" }), 25_000);

export async function onSms(phone, sender, text) {
  const res = await fetch(`${API}/sms`, { method: "POST", headers, body: JSON.stringify({ phone, sender, text }) });
  return res.json(); // { accepted: true, code: "123456" }
}

Kurallar ve ödemeler

Fiyat aralığı

Numara başına 0,02 $ ile 10 $; kiralamada günlük 0,10 $ ile 50 $.

Komisyon

Seviyeye göre: A %15, B %20, C %25. Yeni satıcılar B seviyesinde başlar.

Bekleme

Her kazanç 72 saat bekler; bu sürede açılan haklı şikâyetler kazancı geri alır.

Teminat

50 $ + SIM başına 1 $; kazançların %20'si teminat dolana kadar ayrılır.

Deneme süresi

İlk 14 gün: aynı anda en fazla 50 açık numara ve günde 50 $ ödeme.

Puan

Teslim oranı (%40), ilk SMS süresi (%20), çevrimiçi süre (%20) ve şikâyet oranı (%20). Puan 50'nin altına inerse satış durur.

Ödeme

USDT, en az 10 $. A ve B seviyesi her gün, C seviyesi haftada bir çekebilir.

Hata kodları

401 bad_key

Anahtar yanlış, iptal edilmiş ya da istek izin listesinde olmayan bir IP'den geldi.

400 bad_request

Gövde eksik ya da hatalı; issues alanı hangi alanın sorunlu olduğunu söyler.

403 not_seller

Hesap satıcı programında değil ya da kapatılmış.

409 phone_taken

Bu numara başka bir satıcıya kayıtlı.

400 price_out_of_range

Fiyat izin verilen aralığın dışında.

409 payout_limit

Tutar en düşük ödemenin altında ya da günlük deneme sınırını aşıyor.

409 payout_too_soon

Seviyenize göre bir sonraki ödeme günü henüz gelmedi.

403 payout_frozen

Puan ya da hesap durumu nedeniyle ödemeler geçici olarak durduruldu.

429

Dakikalık istek sınırı aşıldı; biraz bekleyip tekrar deneyin.