SMS-Versand mit Kotlin: API-Bibliothek

SMS-Versand mit Kotlin: API-Bibliothek für die schnelle Integration

In der modernen Webentwicklung bleibt die Möglichkeit, programmatisch SMS-Nachrichten zu versenden, eine gefragte Funktion – von der Zwei-Faktor-Authentifizierung bis hin zu Benachrichtigungen über den Bestellstatus. Wenn Sie Kotlin für den Serverteil (Ktor, Spring Boot) oder eine mobile App (Android) verwenden, benötigen Sie ein zuverlässiges Werkzeug für die Arbeit mit SMS-Anbietern. In diesem Artikel betrachten wir die API-Bibliothek für den SMS-Versand mit Kotlin, ihre Funktionen, Integrationsbeispiele und bewährte Verfahren.

Was ist eine API-Bibliothek für den SMS-Versand?

Eine API-Bibliothek ist eine Sammlung von Klassen und Funktionen, die die Arbeit mit HTTP-Anfragen an den Server des SMS-Anbieters abstrahiert. Anstatt manuell URLs und Header zu erstellen und JSON zu parsen, rufen Sie einfache Kotlin-Methoden auf: sendSms(phone, message). Die Bibliothek übernimmt die Authentifizierung, Serialisierung, Wiederholungsversuche bei Netzwerkfehlern und die Verarbeitung von Antworten.

Hauptfunktionen der Bibliothek

Einfacher SMS-Versand – Angabe der Empfängernummer, des Textes und optional des Absendernamens (Alpha-Name).
Massenversand – Senden einer Nachricht an eine Liste von Nummern.
Statusprüfung – Abrufen von Informationen über die Zustellung (zugestellt, in der Warteschlange, Fehler).
Unterstützung verschiedener Anbieter – Twilio, Vonage (Nexmo), SMSC.ru, Smsc.ua und andere.
Asynchronität – Alle Methoden geben suspend-Funktionen oder Deferred für Koroutinen zurück.
Protokollierung und Fehlerbehandlung – Integrierte Mechanismen zur Fehlersuche.

Installation und Einbindung

Die Bibliothek wird über Maven Central oder JitPack verbreitet. Fügen Sie die Abhängigkeit in build.gradle.kts hinzu:

// build.gradle.kts (für Gradle Kotlin DSL)dependencies {    implementation("com.example:sms-api:1.0.0")    // falls Sie den Ktor Client verwenden    implementation("io.ktor:ktor-client-core:2.3.0")    implementation("io.ktor:ktor-client-okhttp:2.3.0")}

Für Android fügen Sie außerdem die Internetberechtigung in AndroidManifest.xml hinzu.

Basisbeispiel für den SMS-Versand

Betrachten wir ein minimales Beispiel für den Versand einer einzelnen Nachricht über den Anbieter SMSC.ru (analog für andere).

import com.example.smsapi.SmsClientimport com.example.smsapi.model.SmsRequestimport com.example.smsapi.model.SmsResponse

suspend fun sendSingleSms() {    // Client mit Anmeldedaten erstellen    val client = SmsClient.create(        login = "your_login",        password = "your_password",        provider = SmsProvider.SMSC    )

    // Anfrage erstellen    val request = SmsRequest(        phone = "+71234567890",        message = "Ihr Bestätigungscode: 1234",        sender = "MyApp" // Alpha-Name, falls unterstützt    )

    // Senden und Antwort empfangen    val response: SmsResponse = client.send(request)

    when (response.status) {        SmsStatus.SUCCESS -> println("SMS gesendet, ID: ${response.id}")        SmsStatus.ERROR -> println("Fehler: ${response.errorMessage}")        else -> println("Unbekannter Status")    }}

Massenversand

Um eine Nachricht an mehrere Nummern zu senden, verwenden Sie die Methode sendBatch:

val phones = listOf("+71234567890", "+70987654321", "+71112223344")val batchRequest = BatchSmsRequest(    phones = phones,    message = "Sehr geehrte Kunden, die Aktion wurde bis Freitag verlängert!",    sender = "ShopBot")

val batchResponse = client.sendBatch(batchRequest)batchResponse.results.forEach { result ->    println("Telefon: ${result.phone}, Status: ${result.status}")}