Simply ConnectPrzejdź do panelu
IntegracjeKotlin

Kotlin bez Spring Boot · v0.1.0

Simply Connect
dla Kotlina.

Kotlin korzysta bezpośrednio z null-safe API modułu JVM. Dostajesz osobną instrukcję Gradle Kotlin DSL i przykłady w Kotlinie, choć artefakt bazowy jest wspólny z Javą.

Pobierz wydanie v0.1.0 Pokaż instrukcję
Gotowa integracja · v0.1.0

Dla kogo jest ta integracja

Najpierw sprawdź, czy to rozwiązanie dla Ciebie.

Dla aplikacji Kotlin/JVM, Ktor i workerów bez Spring Boot. Jeżeli używasz Spring Boot z Kotlinem, wybierz poradnik Spring Boot.

Co dostajesz

Mniej ręcznej pracy.
Więcej pewności.

01

Kod i konfiguracja pokazane w Kotlinie

02

Bezpośrednie użycie modułu JVM

03

SMS-y, historia i bramki

04

Flow IVR i kolejka połączeń

05

Bezpieczna idempotencja operacji

Instalacja krok po kroku

Bez zgadywania. Zrobisz to po kolei.

Każdy krok mówi, gdzie wejść i czego oczekiwać. Najpierw uruchom podstawową wysyłkę, dopiero potem włącz kolejne automatyzacje.

  1. 1

    Dodaj JitPack w Kotlin DSL

    W settings.gradle.kts dodaj JitPack obok Maven Central. Nie potrzebujesz konta ani tokenu GitHub.

    dependencyResolutionManagement {
    repositories {
        mavenCentral()
        maven("https://jitpack.io")
    }
}
  2. 2

    Zainstaluj wspólny moduł JVM

    Kotlin nie potrzebuje osobnego artefaktu. Moduł simply-connect-java udostępnia to samo typowane API bez adaptera.

    implementation("com.github.karlos1998.simply-connect-jvm:simply-connect-java:v0.1.0")
  3. 3

    Utwórz klucz API

    W panelu Simply Connect otwórz Developer → API keys. Włącz SMS_SEND oraz tylko te dodatkowe zakresy, których potrzebuje aplikacja.

    Otwórz panel Simply Connect
  4. 4

    Dodaj sekrety do środowiska

    Klucz i UUID bramki trzymaj poza repozytorium. W Ktorze lub innym frameworku wczytaj je podczas startu serwera.

    SIMPLY_CONNECT_API_KEY=msc_live_twoj_sekret
SIMPLY_CONNECT_SMS_ENDPOINT_ID=uuid_twojej_bramki
  5. 5

    Wyślij SMS z Kotlina

    Utwórz klienta raz na proces i używaj stabilnego klucza idempotencji dla tej samej operacji biznesowej.

    val client = SimplyConnectClient.builder()
    .apiKey(System.getenv("SIMPLY_CONNECT_API_KEY"))
    .defaultSmsEndpointId(UUID.fromString(
        System.getenv("SIMPLY_CONNECT_SMS_ENDPOINT_ID")
    ))
    .build()

val result = client.sendSms(
    "+48500100200",
    "Twoje zamówienie jest gotowe.",
    "order-1842-ready"
)

Test po instalacji

Po czym poznasz, że wszystko działa?

Nie zaczynaj od masowej wysyłki. Przejdź tę krótką listę na jednym kontrolowanym numerze.

  1. 1Kod kompiluje się z targetem JVM 17 bez adaptera Kotlin.
  2. 2Lista endpointów pokazuje bramki dostępne dla klucza.
  3. 3Kontrolny SMS zwraca identyfikatory i status QUEUED.
  4. 4Wiadomość pojawia się w Simply Connect i wychodzi wybranym numerem.

Gdy coś nie ruszy

Najczęstsze problemy

Najpierw sprawdź poniższe rzeczy — zwykle rozwiązanie jest tutaj.

Dlaczego artefakt nazywa się simply-connect-java?

To wspólny, framework-neutralny moduł JVM. Kotlin wywołuje jego null-safe rekordy i builder bez dodatkowego adaptera. Osobny jest dopiero starter Spring Boot.

Gradle nie znajduje paczki

Sprawdź wpis maven("https://jitpack.io") w settings.gradle.kts oraz wersję z prefiksem v0.1.0.

Używam Kotlin + Spring Boot

Przejdź do poradnika Spring Boot. Starter tworzy bean SimplyConnectClient, który możesz normalnie wstrzykiwać do klas napisanych w Kotlinie.

Gotowe do uruchomienia

Połącz Kotlin z własnym numerem.

Integracja jest otwarta i wersjonowana. Kod możesz sprawdzić przed instalacją, a w razie pytania napisać do nas.

Nazwy i znaki należą do ich właścicieli. Integracja nie oznacza partnerstwa ani certyfikacji przez właściciela danego narzędzia.
Pobierz wydanie v0.1.0 Zobacz kod na GitHubiePotrzebujesz pomocy?