[wp_sms_verify_form]
[wp_sms_wallet_dashboard]
API Gateway Entegrasyon Dokümantasyonu
Sanal numara kiralama ve SMS onay işlemlerini kendi sistemlerinize entegre etmek için SMS Gateway v1 protokol detayları.
ℹ️
5sim / SMS-Activate Protokol Uyumluluğu
API protokolümüz, standart SMS-Activate ve 5sim entegrasyon şablonlarıyla %100 uyumludur. Mevcut yazılımlarınızda sadece API URL (Base URL) ve API Key tanımlayarak hemen kullanmaya başlayabilirsiniz.
1 Genel Kurallar ve Kimlik Doğrulama
Tüm API istekleri güvenli bağlantı üzerinden HTTP GET metodu kullanılarak gerçekleştirilir. İsteklerinizi doğrulamak için her sorguda hesabınıza ait API anahtarını api_key parametresi olarak iletmelisiniz.
API Anahtarı (API Key)
API Anahtarınızı cüzdan panelinizdeki Wallet Dashboard > API Integration sekmesinden edinebilirsiniz. API Anahtarınızın güvenliğini korumalı, üçüncü şahıslarla paylaşmamalısınız.
API İstek Adresleri (Base URL)
Önerilen
https://siteniz.com/sms-api
Alternatif
https://siteniz.com/?wp_sms_api=1
2 API Metotları ve Protokol Detayları
3 Hata Kodları Referansı
Sistem genelinde dönen tüm standart hata mesajları ve çözümleri aşağıda listelenmiştir:
| Hata Kodu | Açıklama ve Çözüm Ayrıntısı |
|---|---|
| BAD_KEY | Geçersiz veya eksik API anahtarı. Anahtarınızı cüzdan panelinden kontrol edin. |
| BAD_ACTION | Gönderilen aksiyon geçersiz veya eksik (action parametresini doğrulayın). |
| NO_BALANCE | Cüzdan bakiyeniz yetersiz. Lütfen web sitesi üzerinden bakiye yüklemesi yapın. |
| NO_NUMBERS | Sağlayıcılarda veya seçilen ülkede uygun stok bulunamadı. Lütfen daha sonra deneyin. |
| NO_ACTIVATION | Belirtilen ID değerine sahip bir sipariş bulunamadı veya sipariş hesaba ait değil. |
| BAD_SERVICE | Geçersiz ülke adı veya geçersiz servis kodu. Protokol listesini inceleyin. |
| PREVENT_RACE_CONDITION | Aynı anda çoklu istek engeli. İki kiralama isteği arasında en az 10 saniye olmalıdır. |
4 Entegrasyon Kod Örnekleri
4.1 Python Entegrasyon Örneği
import time import requests API_KEY = "YOUR_API_KEY" BASE_URL = "https://siteniz.com/sms-api" # 1. Bakiye Kontrolü balance_resp = requests.get(f"{BASE_URL}?api_key={API_KEY}&action=getBalance") print("Cüzdan Bakiyesi:", balance_resp.text) # 2. Sanal Numara Satın Al (WhatsApp - Türkiye) buy_params = { "api_key": API_KEY, "action": "getNumber", "country": "turkey", "service": "wa" } buy_resp = requests.get(BASE_URL, params=buy_params) print("Sipariş Yanıtı:", buy_resp.text) if buy_resp.text.startswith("ACCESS_NUMBER"): parts = buy_resp.text.split(":") activation_id = parts[1] phone_number = parts[2] print(f"Numara Alındı! ID: {activation_id} | Tel: {phone_number}") # 3. Belirli aralıklarla SMS Kodu sorgulama print("SMS kodu bekleniyor...") for _ in range(18): # 3 dakika boyunca sorgula time.sleep(10) status_resp = requests.get(f"{BASE_URL}?api_key={API_KEY}&action=getStatus&id={activation_id}") if status_resp.text.startswith("STATUS_OK"): sms_code = status_resp.text.split(":")[1] print(f"SMS Kodu Alındı: {sms_code}") # Siparişi Onayla requests.get(f"{BASE_URL}?api_key={API_KEY}&action=setStatus&id={activation_id}&status=6") break elif status_resp.text == "STATUS_CANCEL": print("Sipariş zaman aşımı veya harici sebeplerle iptal edildi.") break else: # SMS gelmediyse siparişi iptal et (bakiye iadesi) print("Süre bitti. Sipariş iptal ediliyor...") requests.get(f"{BASE_URL}?api_key={API_KEY}&action=setStatus&id={activation_id}&status=8")
4.2 cURL (Terminal) Hızlı Test Komutları
# Bakiye Sorgulama curl "https://siteniz.com/sms-api?api_key=YOUR_API_KEY&action=getBalance" # Numara Satın Alma (WhatsApp - Türkiye) curl "https://siteniz.com/sms-api?api_key=YOUR_API_KEY&action=getNumber&country=turkey&service=wa" # SMS Kodunu Sorgula (Sipariş ID: 1425) curl "https://siteniz.com/sms-api?api_key=YOUR_API_KEY&action=getStatus&id=1425" # Siparişi Onaylayarak Sonlandır (Sipariş ID: 1425) curl "https://siteniz.com/sms-api?api_key=YOUR_API_KEY&action=setStatus&id=1425&status=6" # Siparişi İptal Et ve Bakiyeyi İade Al (Sipariş ID: 1425) curl "https://siteniz.com/sms-api?api_key=YOUR_API_KEY&action=setStatus&id=1425&status=8"