SMS-Versand mit Kotlin: API-Bibliothek sms-client-kotlin |…

SMS-Versand mit Kotlin: API-Bibliothek sms-client-kotlin

Moderne mobile Anwendungen und Serverlösungen erfordern häufig die Integration mit SMS-Gateways zum Versand von Benachrichtigungen, Bestätigungen oder Marketingnachrichten. Für die Sprache Kotlin gibt es die praktische Bibliothek sms-client-kotlin, die eine einfache und typsichere API für die Arbeit mit gängigen SMS-Anbietern bereitstellt. In diesem Artikel werden wir ihre Architektur, Methoden und Anwendungsbeispiele im Detail besprechen.

Was ist sms-client-kotlin?

Die Bibliothek sms-client-kotlin ist ein leichtgewichtiger HTTP-Client, der in reinem Kotlin unter Verwendung von Coroutinen geschrieben ist. Sie abstrahiert die Arbeit mit den REST-APIs verschiedener SMS-Anbieter (z. B. Twilio, Vonage, SMS-Center) und bietet eine einheitliche Schnittstelle zum Versenden von Nachrichten. Hauptvorteile:

Asynchronität – alle Anfragen werden über Kotlin-Coroutinen ausgeführt.
Typsicherheit – strenge Typisierung von Anfrage- und Antwortparametern.
Modularität – Unterstützung mehrerer Anbieter über eine einheitliche Schnittstelle SmsSender.
Einfache Konfiguration – minimale Anzahl von Abhängigkeiten.

Installation und Einbindung

Um die Bibliothek zum Projekt hinzuzufügen, verwenden Sie Gradle. Fügen Sie die Abhängigkeit in die Datei build.gradle.kts ein:

dependencies {    implementation("com.github.sms-client:sms-client-kotlin:1.2.0")    implementation("io.ktor:ktor-client-core:2.3.0")    implementation("io.ktor:ktor-client-cio:2.3.0") // oder eine andere Engine}

Nach der Synchronisierung des Projekts können Sie eine Instanz des Clients erstellen. Beispiel für die Initialisierung für den Anbieter Twilio:

import sms.client.SmsClientimport sms.client.provider.twilio.TwilioConfig

fun main() {    val config = TwilioConfig(        accountSid = "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",        authToken = "your_auth_token_here",        fromNumber = "+1234567890"    )

    val client = SmsClient.create(config)}

Wichtige API-Methoden

Die Bibliothek bietet mehrere Schlüsselmethoden zum Senden und Verwalten von SMS:

1. Senden einer einzelnen Nachricht

Die Methode sendSms akzeptiert die Empfängernummer und den Nachrichtentext. Sie gibt ein Objekt SmsResult mit Informationen zum Versand zurück.

suspend fun sendSingleMessage(client: SmsClient) {    val result = client.sendSms(        to = "+79876543210",        message = "Hallo! Dies ist eine Testnachricht aus Kotlin."    )

    when (result) {        is SmsResult.Success -> println("Gesendet! ID: ${result.messageId}")        is SmsResult.Failure -> println("Fehler: ${result.errorMessage}")    }}

2. Massenversand

Für Massenaussendungen verwenden Sie die Methode sendBatch. Sie akzeptiert eine Liste von Empfängern und einen gemeinsamen Text (oder individuelle Nachrichten).

suspend fun sendBatch(client: SmsClient) {    val recipients = listOf(        BatchRecipient("+79111111111", "10% Rabatt auf Ihre erste Bestellung!"),        BatchRecipient("+79222222222", "Ihr Bestätigungscode: 1234")    )

    val batchResult = client.sendBatch(recipients)    println("Erfolgreich gesendet: ${batchResult.successCount}, Fehler: ${batchResult.failureCount}")}

3. Überprüfung des Lieferstatus

Die Methode getDeliveryStatus ermöglicht es, den aktuellen Status einer zuvor gesendeten Nachricht anhand ihrer ID abzurufen.

suspend fun checkStatus(client: SmsClient, messageId: String) {    val status = client.getDeliveryStatus(messageId)    println("Status der Nachricht $messageId: ${status.status} (${status.description})")}