smskap 1.0.0__py3-none-any.whl

smskap/__init__.py

@@ -0,0 +1,15 @@
+"""
+SMSKap Official Python SDK
+==========================
+Next-generation physical SIM non-VoIP SMS verification and virtual numbers.
+Supported Services: WhatsApp, WhatsApp Business, Telegram
+Supported Geographies: Turkey (+90), United States (+1), United Kingdom (+44)
+
+Website: https://www.smskap.com/
+"""
+
+from .client import SMSKapClient, SMSKapError
+
+__version__ = "1.0.0"
+__author__ = "SMSKap Engineering"
+__all__ = ["SMSKapClient", "SMSKapError", "__version__"]

smskap/client.py

@@ -0,0 +1,92 @@
+import requests
+from typing import Dict, Any, Optional
+
+class SMSKapError(Exception):
+    """Custom exception raised for SMSKap API errors."""
+    pass
+
+class SMSKapClient:
+    """
+    Official client for SMSKap SMS Verification & Virtual Phone Number API.
+    
+    Website: https://www.smskap.com/
+    Documentation: https://www.smskap.com/sms-onay
+    """
+
+    BASE_URL = "https://www.smskap.com/api/v1"
+    SUPPORTED_SERVICES = ["whatsapp", "whatsapp_business", "telegram"]
+    SUPPORTED_COUNTRIES = {
+        "tr": {"code": "+90", "name": "Turkey"},
+        "usa": {"code": "+1", "name": "United States"},
+        "uk": {"code": "+44", "name": "United Kingdom"}
+    }
+
+    def __init__(self, api_key: str, timeout: int = 15):
+        if not api_key:
+            raise SMSKapError("API key is required to initialize SMSKapClient.")
+        self.api_key = api_key
+        self.timeout = timeout
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.api_key}",
+            "User-Agent": "SMSKap-Python-SDK/1.0.0 (https://www.smskap.com/)"
+        })
+
+    def get_balance(self) -> Dict[str, Any]:
+        """Fetch real-time user balance and account status."""
+        try:
+            res = self.session.get(f"{self.BASE_URL}/balance", timeout=self.timeout)
+            res.raise_for_status()
+            return res.json()
+        except requests.RequestException as e:
+            raise SMSKapError(f"Balance request failed: {e}")
+
+    def request_number(self, service: str, country: str = "tr") -> Dict[str, Any]:
+        """
+        Request an instant physical SIM virtual phone number.
+        
+        :param service: 'whatsapp', 'whatsapp_business', or 'telegram'
+        :param country: 'tr' (+90), 'usa' (+1), or 'uk' (+44)
+        """
+        service_clean = service.lower().replace(" ", "_")
+        country_clean = country.lower()
+
+        if service_clean not in self.SUPPORTED_SERVICES:
+            raise SMSKapError(
+                f"Unsupported service '{service}'. Supported: {', '.join(self.SUPPORTED_SERVICES)}"
+            )
+
+        if country_clean not in self.SUPPORTED_COUNTRIES:
+            raise SMSKapError(
+                f"Unsupported country '{country}'. Supported: {', '.join(self.SUPPORTED_COUNTRIES.keys())}"
+            )
+
+        payload = {
+            "service": service_clean,
+            "country": country_clean
+        }
+
+        try:
+            res = self.session.post(f"{self.BASE_URL}/rentals", json=payload, timeout=self.timeout)
+            res.raise_for_status()
+            return res.json()
+        except requests.RequestException as e:
+            raise SMSKapError(f"Number allocation failed: {e}")
+
+    def get_sms_code(self, activation_id: str) -> Dict[str, Any]:
+        """Poll incoming OTP verification code for a requested number."""
+        try:
+            res = self.session.get(f"{self.BASE_URL}/rentals/{activation_id}", timeout=self.timeout)
+            res.raise_for_status()
+            return res.json()
+        except requests.RequestException as e:
+            raise SMSKapError(f"SMS retrieval failed: {e}")
+
+    def cancel_number(self, activation_id: str) -> Dict[str, Any]:
+        """Cancel number and trigger 100% automated balance refund if OTP not received."""
+        try:
+            res = self.session.delete(f"{self.BASE_URL}/rentals/{activation_id}", timeout=self.timeout)
+            res.raise_for_status()
+            return res.json()
+        except requests.RequestException as e:
+            raise SMSKapError(f"Cancellation failed: {e}")

smskap-1.0.0.dist-info/METADATA

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: smskap
+Version: 1.0.0
+Summary: SMSKap Official Python SDK - Non-VoIP real carrier SMS verification and virtual phone numbers for WhatsApp, WhatsApp Business, and Telegram.
+Author-email: SMSKap Engineering <support@smskap.com>
+Project-URL: Homepage, https://www.smskap.com/
+Project-URL: Documentation, https://www.smskap.com/sms-onay
+Project-URL: WhatsApp Sanal Numara, https://www.smskap.com/whatsapp-sanal-numara
+Project-URL: Global Virtual Numbers, https://www.smskap.com/en/whatsapp-virtual-number
+Project-URL: Telegram Verification, https://www.smskap.com/telegram-sanal-numara
+Project-URL: Source, https://github.com/smsonay34/smskap-telecom-api
+Keywords: sms-onay,wp-sanal-numara,sanal-numara-alma,whatsapp-virtual-number,telegram-virtual-number,non-voip,usa-virtual-number,uk-virtual-number,smskap
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Communications :: Telephony
+Classifier: Topic :: Security
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+
+# SMSKap Official Python SDK 🚀
+
+[![PyPI version](https://img.shields.io/pypi/v/smskap.svg)](https://pypi.org/project/smskap/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/smskap.svg)](https://pypi.org/project/smskap/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+**[SMSKap](https://www.smskap.com/)** is an enterprise-grade telecommunications and physical cellular carrier routing platform delivering single-use disposable SMS verification codes and private virtual phone numbers.
+
+Designed specifically for mission-critical workflows across **WhatsApp**, **WhatsApp Business**, and **Telegram**, SMSKap routes OTP traffic through authentic physical SIM cards across **Turkey (+90)**, **United States (+1)**, and the **United Kingdom (+44)**.
+
+---
+
+## 📌 Primary Features & Telecom Standards
+
+* **100% Real Carrier Non-VoIP Routing:** Eliminates Meta and Telegram VoIP fraud detection filters to ensure 0% ban rates.
+* **Instant OTP Delivery (10–30s):** Direct HLR-connected cellular base station query protocol.
+* **Automated 100% Refund Guarantee:** If an activation code does not arrive within 60–90 seconds, the allocated balance is automatically refunded.
+* **Single-Use Confidentiality:** Numbers are allocated strictly on a single-use basis and permanently retired to protect account privacy.
+
+---
+
+## 🔗 Official Portals & Core Services
+
+* **Ana Platform:** [SMS Onay ve Sanal Numara Al](https://www.smskap.com/)
+* **WhatsApp Hat Tahsisi (TR):** [wp sanal numara](https://www.smskap.com/whatsapp-sanal-numara)
+* **SMS Doğrulama Servisi (TR):** [sms onay](https://www.smskap.com/sms-onay)
+* **Tek Kullanımlık Numara Alma:** [sanal numara alma](https://www.smskap.com/sanal-numara)
+* **Telegram Doğrulama:** [telegram sanal numara](https://www.smskap.com/telegram-sanal-numara)
+* **Global Verification (EN):** [WhatsApp virtual number](https://www.smskap.com/en/whatsapp-virtual-number)
+* **Enterprise Non-VoIP Numbers:** [non-VoIP virtual phone numbers](https://www.smskap.com/en/virtual-phone-number)
+* **North America Routing (+1):** [USA virtual number](https://www.smskap.com/en/usa-virtual-number)
+* **United Kingdom Routing (+44):** [UK virtual number](https://www.smskap.com/en/uk-virtual-number)
+
+---
+
+## 📦 Installation
+
+```bash
+pip install smskap
+```
+
+---
+
+## 🚀 Quickstart Example
+
+```python
+from smskap import SMSKapClient, SMSKapError
+
+# Initialize client with your private API key
+client = SMSKapClient(api_key="YOUR_SMSKAP_API_KEY")
+
+try:
+    # 1. Check account balance
+    balance = client.get_balance()
+    print("Available Balance:", balance)
+
+    # 2. Request an authentic physical SIM number for WhatsApp in Turkey (+90)
+    # Supported services: 'whatsapp', 'whatsapp_business', 'telegram'
+    # Supported countries: 'tr' (+90), 'usa' (+1), 'uk' (+44)
+    rental = client.request_number(service="whatsapp", country="tr")
+    print(f"Allocated Phone Number: {rental['phone_number']}")
+    print(f"Activation ID: {rental['id']}")
+
+    # 3. Poll for the incoming SMS verification code
+    sms = client.get_sms_code(rental["id"])
+    if sms.get("code"):
+        print(f"Received SMS Verification Code: {sms['code']}")
+    else:
+        print("Waiting for SMS dispatch...")
+
+except SMSKapError as e:
+    print(f"SMSKap Error: {e}")
+```
+
+---
+
+## 📊 Physical Carrier SIM vs. Virtual VoIP Routing
+
+| Metric | SMSKap Physical Carrier SIM | Shared VoIP Services |
+| :--- | :--- | :--- |
+| **Carrier Detection** | Real GSM Mobile Carrier (Turkcell, Vodafone, EE, AT&T) | Virtual PBX / VoIP Datacenter |
+| **WhatsApp Ban Risk** | **0% (Verified Mobile SMR)** | High (Blacklisted by Meta) |
+| **Telegram Ban Risk** | **0% (HLR-verified cellular network)** | Immediate Account Suspension |
+| **Refund Policy** | **100% Automated if no code received** | Manual / No refund |
+| **Delivery Speed** | Instant Cellular Route (10–30s) | Unreliable / High Latency |
+
+---
+
+## 🛡️ License
+
+This project is licensed under the MIT License — see the [LICENSE](https://opensource.org/licenses/MIT) file for details.
+Official Website: [https://www.smskap.com/](https://www.smskap.com/)

smskap-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+smskap/__init__.py,sha256=byY_vSvdUyHdI1_6c2npzqjqosUlP2PumLDoHr8M1dE,469
+smskap/client.py,sha256=gYoVc9fO9O39-YU733_ydhspWwMp5mq1Dj8a7ogPvmw,3597
+smskap-1.0.0.dist-info/METADATA,sha256=-M7_aq-JWLDVYLZi8_oqYP9Bc2Bo_vJ1UAcHChzKISw,6058
+smskap-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+smskap-1.0.0.dist-info/top_level.txt,sha256=AnDl9wZQZY92TJclCzMWJpIRnnMSYeg2hTTri-8fla0,7
+smskap-1.0.0.dist-info/RECORD,,

smskap-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

smskap-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+smskap