Kotlin SMS भेजना: smslib4k API लाइब्रेरी गाइड

Kotlin में smslib4k लाइब्रेरी से SMS भेजना

आधुनिक वेब डेवलपमेंट में SMS नोटिफिकेशन का इंटीग्रेशन एक ज़रूरी काम है: टू-फ़ैक्टर ऑथेंटिकेशन, ऑर्डर स्टेटस अपडेट, रिमाइंडर। Kotlin भाषा के लिए smslib4k नामक एक बेहतरीन लाइब्रेरी है, जो लोकप्रिय SMS प्रोवाइडर के साथ REST API के ज़रिए काम करने का एक समान इंटरफ़ेस प्रदान करती है।

यह लाइब्रेरी शुद्ध Kotlin में कोरूटीन (kotlinx.coroutines) के साथ लिखी गई है और एसिंक्रोनस मैसेज भेजने को सपोर्ट करती है। यह Twilio, Vonage, SMS-सेंटर, SMS-राय जैसे प्रोवाइडर के बीच के अंतर को एब्सट्रैक्ट करती है, जिससे डेवलपर बिज़नेस लॉजिक पर फोकस कर सकता है।

इंस्टॉलेशन और सेटअप

smslib4k का उपयोग करने के लिए build.gradle.kts में डिपेंडेंसी जोड़ें:

repositories {
    mavenCentral()
}

dependencies {
    implementation("io.github.smslib4k:smslib4k-core:2.1.0")
    // किसी विशेष प्रोवाइडर के लिए, जैसे Twilio:
    implementation("io.github.smslib4k:smslib4k-twilio:2.1.0")
}

Gradle सिंक करने के बाद लाइब्रेरी उपयोग के लिए तैयार है।

क्लाइंट की बेसिक इनिशियलाइज़ेशन

हर प्रोवाइडर को अपनी क्रेडेंशियल्स चाहिए। आइए SMS-सेंटर (एक लोकप्रिय प्रोवाइडर) के लिए सेटअप देखें:

import io.github.smslib4k.core.SmsClient
import io.github.smslib4k.providers.smscenter.SmsCenterProvider

fun main() {
    val client = SmsClient(
        provider = SmsCenterProvider(
            login = "your_login",
            password = "your_password"
        )
    )
    println("SMS क्लाइंट इनिशियलाइज़ हो गया")
}

Twilio के लिए भी यही संरचना होगी, लेकिन इसमें accountSid और authToken की ज़रूरत होगी।

एकल SMS भेजना

लाइब्रेरी सिंक्रोनस और एसिंक्रोनस दोनों तरीकों को सपोर्ट करती है। कोरूटीन का उपयोग करने की सलाह दी जाती है:

import kotlinx.coroutines.runBlocking
import io.github.smslib4k.core.model.SmsMessage

fun main() = runBlocking {
    val client = createClient() // पिछले उदाहरण का फंक्शन

    val message = SmsMessage(
        to = "+919876543210",
        text = "नमस्ते! यह Kotlin से एक टेस्ट मैसेज है।"
    )

    val result = client.send(message)
    println("स्थिति: ${result.status}")
    println("मैसेज ID: ${result.messageId}")
}

send मेथड एक SmsResult ऑब्जेक्ट लौटाता है, जिसमें स्थिति (SUCCESS, FAILED, PENDING) और प्रोवाइडर का यूनिक आइडेंटिफ़ायर होता है।

बल्क मैसेजिंग

एक ही टेक्स्ट कई नंबरों पर भेजने के लिए sendBatch का उपयोग करें:

val recipients = listOf(
    "+919876543210",
    "+919876543211",
    "+919876543212"
)

val batchResult = client.sendBatch(
    to = recipients,
    text = "ऑफ़र! इस हफ्ते सभी उत्पादों पर 20% की छूट।"
)

batchResult.forEach { (phone, result) ->
    println("$phone: ${result.status}")
}

लाइब्रेरी बिल्ट-इन रेट-लिमिटर का उपयोग करके प्रोवाइडर के प्रति सेकंड रिक्वेस्ट की सीमा को ऑटोमैटिकली हैंडल करती है।

अतिरिक्त पैरामीटर सेट करना

कई प्रोवाइडर एडवांस्ड ऑप्शन सपोर्ट करते हैं: सेंडर का नाम (अल्फा-नेम), ट्रांज़ैक्शनल फ़्लैग, मैसेज का टाइम-टू-लिव। smslib4k में यह बिल्डर के ज़रिए किया जाता है:

val message = SmsMessageBuilder()
    .to("+919876543210")
    .text("आपका वेरिफिकेशन कोड: 1234")
    .sender("MyApp")          // अल्फा-नेम (यदि प्रोवाइडर अनुमति दे)
    .ttl(300)                 // सेकंड में टाइम-टू-लिव
    .isTransactional(true)    // प्राथमिकता डिलीवरी
    .build()

client.send(message)

एरर हैंडलिंग

लाइब्रेरी नेटवर्क समस्याओं या गलत क्रेडेंशियल्स पर एक्सेप्शन फेंकती है। कॉल को try-catch में लपेटने की सलाह दी जाती है:

try {
    val result = client.send(message)
    if (result.status == SmsStatus.FAILED) {
        println("भेजने में विफल: ${result.errorMessage}")
    }
} catch (e: Exception) {
    println("एरर: ${e.message}")
}

निष्कर्ष

smslib4k Kotlin डेवलपर्स के लिए एक शक्तिशाली और लचीली लाइब्रेरी है। यह कोरूटीन, बिल्ट-इन रेट लिमिटिंग और कई प्रोवाइडर के सपोर्ट के साथ SMS इंटीग्रेशन को आसान बनाती है। चाहे आप OTP भेज रहे हों या मार्केटिंग कैंपेन चला रहे हों, यह लाइब्रेरी आपकी ज़रूरतों को पूरा करेगी।